会SQL语句，就能快速开放你的数据接口API

Posted 2023-03-21

参考技术A 如果你是非技术开发工程，不熟悉Java、php、Python、Golang这些后端的编程语言，但熟悉mysql、Oracle、SQL Server、PostgreSQL这些数据库的查询操作，当你需要把现有的数据库的数据，通过API接口形式提供给外部人员使用时，使用派框架·接口大师这个工具，就能轻松实现。

派框架·接口大师，是一套研发、管理和开放API接口的软件源代码和解决方案，基于PhalApi开源接口框架+Vue前后端分离，可用于快速搭建各类企业级接口平台。

适合用于开发新项目、已使用PhalApi开源框架的项目，或现有项目的系统重构，可用于快速搭建：OpenAPI、接口平台、数据平台、PaaS平台、SaaS平台、BaaS平台、开放平台等。

本地安装好后，就可以开始使用了。

假设我们已经在以下的国家数据库表pp_countries：

字段 sortname：表示国家简称，name 表示国家全称，还有区号phonecode，以及经纬度字段。

现在使用 接口大师 这个工具，介绍如何低代码开发、管理和开放你的数据API接口。

进入接口大师的管理后台，进入接口管理-低代码接口开发-添加接口。

接口设计类型选择：生成数据库表接口API。

在接口服务名称这里，把类名改成你的数据库表名，不需要带表前缀，同时使用大写开头的坨峰法写法。

在接口参数填写需要支持的搜索参数。

例如，支持国家名称的模糊匹配。

接下来，点击生成代码。会生成类似如下的PHP代码：

例如，找到SQL这一行的语句：

改成你自己的SQL语句，例如模糊搜索国家名。

同时把参数调整成左右模糊匹配：

然后，点击【保存并发布】。

发布接口后，就可以在OpenAPI在线接口文档看到刚刚添加发布的新数据接口。

点击可以进入新接口的在线接口文档。截图如下：

你可以在线进行接口测试。填入需要搜索的国家名，例如：输入A。

可以看到接口返回以下数据：

开启调试模式后，还可以看到背后执行的SQL语句和执行时间：

完善接口文档

你还可以补充添加接口返回的结构、字段说明。

再次发布后，就可以在前台接口文档查看到：

最后，再来看下如何把你开发添加好的新数据接口API开放给其他人。

开发者的主要使用流程是：

所以，开发者，需要先到开放平台注册一个新账号，然后登录。

再创建新的应用并等待后台审核通过：

应用通过审核后，根据app_key和密钥，申请接口访问令牌。

获取到访问令牌access_token后，就可以调用和使用你新添加的数据API接口。