未来,开发接口可能是这样的 —— 低代码接口编程

原创
2020/04/02 09:16
阅读数 140


 

未来,会是低代码接口编程?

从0101机器代码,到汇编语言,再到高级编程语言,以及现在的元编程、声明式编程和AI编程。我们有理由相信,在不久的未来,将会有更高阶的第五代编程语言出现,或者会集成度更高对开发者更友好的开发工具出现,进一步减轻我们项目过程中重复的编码量,减少常见的代码缺陷、统一编程开发范式和流程规范化。


接口项目开发这一细分领域,我们正在通过PhalApi Pro,致力追求接口编程的低代码开发,甚至无代码开发。让开发者只需要编写少量代码或者完全不需要编写代码就能快速拥有一套能满足项目需求的接口服务。


如果你完全是开发接口的新手,那么通过PhalApi Pro,你可以轻轻松松就能掌握专业级的接口开发,这个过程只需要看完这篇文章的时间。


如果你已经有过接口开发的经验,那么通过PhalApi Pro,你会觉得更省事更便捷,你能想到的关于接口的功能基本都有,你还没想到的功能也可能已经提供,或正在路上……


如果你已经是接口开发大师级的人物,那么PhalApi Pro可能会给你带来一些更高阶的启发,给你不一样的收获。


那么——

什么是PhalApi(π框架)?

PhalApi是一个PHP轻量级开源接口框架,致力于快速开发接口服务。支持HTTP/SOAP/RPC等协议,可用于搭建接口/微服务/RESTful接口/Web Services。 从2015年开源到现在,已经越来越多开发者和公司正在使用PhalApi进行接口开发,并且受了很多开发者的衷心喜欢。


PhalApi,让接口开发更简单!

什么是PhalApi Pro?

PhalApi Pro是专业版的接口开发框架,由PhalApi开源框架作者dogstar及其技术团队自主研发,结合近十年接口项目经验用心打造,提供专业的售后服务和技术支持。 


PhalApi Pro(4合1),智慧编程,让接口开发更有趣!

使用PhalApi Pro开发接口是怎样的一种体验?

PhalApi Pro致力于让接口更简单、更轻松、更友好。如果你使用PhalApi Pro进行接口开发和编程,其编程体验可能是这样的……

安装PhalApi Pro

在拿到PhalApi Pro (4合1)专业版的源代码后,参考安装文档,配置后可用浏览器打开安装向导。

PhalApi专业版安装教程:http://pro.api.phalapi.net/wiki/#/install


例如你的接口域名是:http://api.pro.phalapi.net,那么安装界面网址是:http://api.pro.phalapi.net/install,安装成功后会看到是:


点击查看接口文档,可以看到已经有80多款常用的接口,不用开发,可直接用于客户端开发和调用。


还有完整的开发手册,随时查阅。

登录管理后台

使用刚才自己填写的管理员账号和密码,登录管理后台。


成功进入管理后台,可以看到以下管理后台界面:

在左侧菜单 ,可以看到有以下功能菜单:

  • 应用管理

  • 用户管理

  • 接口管理

  • 素材管理

  • 统计

  • 配置管理 

  • 计划任务

  • 技术专区


添加新客户端应用

如果你的接口需要给不同和客户端调用,那么可以先创建一个新应用。如果接口只是自己使用,可以跳过这一步。

点击【应用管理】-【创建新应用】,输入名称和app_key后【保存】。


应用创建成功后可以在列表看到。

可视化接口设计

如果需要开发新的接口,对于初次编写接口的开发同学,可以试下可视化接口设计。


通过【技术专区】-【可视化接口设计】-【填写相关的表单参数】,即可生成一份专业的接口代码骨架。

操作步骤主要分为四步:

  • 第1步:接口设计

  • 第2步:生成代码

  • 第3步:保存代码

  • 第4步:查看接口


例如,我们来设计一个Hello World的接口。


在完成接口设计后,点击右上角的【生成代码】,就可以实时看到右边会出来PHP接口代码。局部放大看一下生成的代码效果:


觉得没问题后,就可以保存代码到本地的PHP文件。并且可以通过在线接口列表文档看到你刚才设计保存的接口。


点击进入接口文档详情页,可以看到更完整的接口文档。这份接口文档会根据PHP代码和PHP注释实时生成,免去人工维护的成本。


如果想要保护你的接口文档,可以设置文档查看密码:

为应用分配/取消接口权限

为了方便客户端使用,默认情况下,新创建的应用会拥有全部的接口权限。如果需要取消应用某个接口的权限,可以进入【接口管理】-【接口权限分配】-选择应用-勾选或去掉接口权限。


首先,选择需要分配权限的应用。


随后,如果不想给此应用分配接口权限,可以进行授权取消。


客户端怎么请求新加的接口?

客户端请求你开发的新接口,都可以分为两步。

第一步:通过接口进行授权,并获得一个新的access_token

第二步:凭着access_token调用接口


在第一步中,获取access_token(访问令牌)可以使用两种方式:

如果客户端的使用者是真实的人,那么客户可以通过已经注册的账号和密码,使用App.Auth.UserLogin接口进行用户登录;

如果客户端是设备,那么可以通过刚才创建的app_key和密钥,使用App.Auth.ApplyToken接口申请令牌。


令牌的意义在于:可以在客户端和服务端接口之间约定一种签名算法,以确保客户端是可信的请求方。你也可以根据自己的项目需求,调整使用其他的接口签名验证方案。


比如,我们现在以刚才创建的新应用来请求刚才设计和开发的新接口。首先,使用App.Auth.ApplyToken接口申请at令牌。


拿到的令牌后,可以在指定的时间内重复使用,在请求接口时需要把此at回传给接口,例如请求刚才的Hello World接口并指定今年是2020年。

这样,客户端就能请求到需要的接口并拿到想要的接口结果和数据了。

如何查看接口日志?

对于客户端曾经请求过的接口,我们可以在管理后台的【技术专区】-【接口日志】中查看。可以看到接口请求的相关信息,还包括响应时间、客户端IP、请求方式等。

如何统计接口流量?

在管理后台,还可以统计客户端请求接口的流量。可以指定统计的日期范围,即可看到对应时间内的接口流量,统计间隔以每小时为区间。

如果我想进行接口自动化测试,怎么办?

PhalApi Pro 1.30最新版本还提供了接口测试功能模块,可以通过添加和编辑接口的测试用例进行全方面无死角的黑盒接口测试。


例如,针对刚才新加的Hello World接口,我们这样添加一个测试用例,期望其返回的ret状态码为200。


和客户端请求一样,接口测试时也需要配置获取access token的方式,例如:


配置好接口的测试用例后,我们可以这样单个执行,在接口测试列表中点击测试,可以看到测试结果。


进入测试用例可以看到更详细的测试报告,以及当前测试用例的测试通过率。


如果需要执行全部测试用例,可以在接口测试用例点击【运行全部测试用例】,并确定执行。


开始测试:


全部测试完成。


测试报告概况:


如果我需要定时执行接口任务呢?

这里,你可以进入管理后台的计划任务,通过添加计划任务来添加新的接口任务。此时,我们也可以继续使用刚才的Hello World接口作为示例,来看下如何添加接口计划任务。


添加完成后,当计划任务被执行后,就可以及时看到其运行结果。你也可以随时启动或关闭接口任务。

还有其他问题?

如果还有其他更多问题,欢迎进入PhalApi Pro的在线演示版亲自体验~

演示地址是:http://pro.phalapi.net/

体验账号和密码是:admin / 123456

PhalApi Pro 1.30 最新版本发布啦!

经过开团队一个多月的紧张开发,PhalApi Pro 1.30 终于发布啦!本次的发布的主要内容有:

    1、添加接口可视化设计模块

    2、添加接口测试模块,一体化测试体系

    3、添加虎皮椒支付

    4、在线接口文档的静态资源从不稳定的CDN调整为本地

    5、上传目录路径支持可配置

    6、添加计划任务模块

    7、修复一些已知的bug


PhalApi Pro开发团队负责人:黄禅宗 PhalApi开源框架作者主力开发攻城狮:何晓宏、王敏杰、何捷聪

感谢使用PhalApi Pro的开发同学和企业,同时也感谢PhalApi Pro开发团队,设计并提供了这么优质的软件作品!


PhalApi Pro后续版本会继续把接口Auth鉴权、整套CURD接口代码自动生成、UI大升级改版、在线支付等理解动人实用贴心的功能整合进来,敬请期待!

PhalApi Pro专业版如何获得授权?

授权套餐如下,分为单次授权和无限制授权,均为永久性授权。个人开发者推荐使用单次授权,企业单位推荐使用无限制永久授权,可用于商业用途。


进入Pro 官网,可以查看和购买授权套餐。

如果你是在校学生,或者是公益组织,可通过各种方式联系我们,免费获取PhalApi Pro专业版源代码(仅限于用于个人学习和公益项目,不得用于商业用途)。根据小白君的经验总结,在校学生提前学好接口开发,可以大大提升自己的就业优势哦~~~


点击下方【阅读原文】进入PhalApi Pro官网可体验在线演示版,购买授权。



本文分享自微信公众号 - 小白开放平台(yesapi)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部