5分钟打造好用好看API文档

2022-11-02 16:53:39 浏览数 (1)

你是否遇到过这样的场景?

  • 对接第三方开放平台文档的时候,左手刷着接口文档看API,右手操作着接口调试工具
  • 写完接口想交付或提供API文档给第三方使用,又觉得文档展示体验一般?很鸡肋?

前言

早期第三方开放平台的开放接口文档,主要以信息展示为主,基本信息包括请求方式、参数说明、返回结果等等。这里以企业微信开发者中心文档为例

而在很长一段时间,为了调试开放接口,我们是不是也是经常习惯左边对着接口文档,右边打开Postman调试。

而在上周微信开放平台上线了调试工具,将文档与在线调试一体化融合。从某种意义上打破了原有单一的信息展示为主的局面

而这样带来的好处就是通过接口文档即可一键抵达调试工具台

️ 那如果其他的开放平台都支持在线调试,是不是效率就提升了一个level?

通过上文我们看到微信实际上提供了一个调试工具赋能原有的接口文档

但是其他平台,如果想省时省力也开发一套具备在线调试的接口文档体系

那Apifox会是你最满意的选择

官网地址:apifox.cn

Apifox在接口文档中集成了调试功能、代码在线生成等等

上图是接口管理Saas服务商Apifox推出的Apihub(开放 API 共享平台)其中企业微信的开放文档。

通过文档在线调试,进一步提升开发者对接开放平台API的效率。

该平台目前已经聚合了大部分主流第三方开放API

换句话说通过Apifox赋能的开放API文档都是具备在线调试、代码生成 。包括一下特征

支持在线调试:点击请求,实时显示调试结果,返回信息一目了然 自动生成代码片段:支持自动生成代码片段,省时省力更高效 ️ 那作为个人开放者,是否可以通过Apifox发布这样好看好用的API文档?

可以的,5分钟教你搞定!

「Apifox发布API文档」

首先我们在Apifox软件的在线分享Tab中找到新建分享按钮

然后在新建分享的弹窗中选择分享属性(文档语言、访问密码、环境选择、分享范围等等)这里以宠物商店Demo为例

保存成功后将鼠标移动到分享列表中的刚刚创建的分享中,点击界面中出现的打开链接

打开Apifox生成接口文档呈现如下,同样也可以支持在线调试!

后续在官网文档也有提及,将会有更多开放区域供我们DIY!

不仅如此,你还可以自定义域名。目前通过Apifox发布的文档使用 xxx.apifox.cn 格式的URL,但是你可以将你的域名直接指向你发布的文档

  • 1.在发布文档 > 发布设置 面板中设置自己自定义的域名
  • 2.添加Apifox的CNAME到你域名厂商的配置中心

最后发布通过你自定义的接口文档,也可以申请发布到上文提到的API Hub中

完成上述操作,你将会收获一个好用好看API文档

  • API文档是支持在线调试的
  • 域名是你自定义的
  • 文档自定义区域是你DIY的

分享给朋友倍有面子!

「最后」

API文档功能只是Apifox强大功能中冰上一角,还提供了API调试、API Mock、API自动化测试等功能

官网地址:apifox.cn

0 人点赞