Skip to main content

接口文档

Apifox

以往,开发团队在进行 API 设计、管理和测试时,常常需要在多个工具 (比如 Postman 和 Swagger) 之间频繁切换。这种方式不仅容易导致数据同步不一致,还阻碍了团队成员之间的协作,最终影响开发效率。

面对这些问题,如果有一个一体化的平台,能将 API 的设计、开发、测试等所有环节整合在一起,会是多么方便!

而 Apifox 正是这样一个一站式 API 开发协作平台!

它集 API 设计、API 开发、API 调试、API 管理、 API 文档、API Mock 和自动化测试等功能于一体,为你的 API 项目提供一站式的解决方案。

下载地址:https://apifox.com

OpenAPI 导入

下载 12306 OpenAPI 文件,存储到电脑本地磁盘文件中。

通过网盘分享的文件:12306.openapi.json
链接: https://pan.baidu.com/s/1R8kGhDnCARb9euHs_GWUVA?pwd=x9pn 提取码: x9pn

导入 Apifox 教程:https://docs.apifox.com/doc-5173626

全局引用用户登录

首先完成 Apifox 软件下载和 12306 相关后端服务启动,然后根据下图流程获取 AccessToken 值。

操作流程如下所示:

使用全局参数的方式设置 Header,避免每个接口都手动添加用户登录 Header。

操作流程如下所示:

接口文档

目前 12306 铁路购票系统开发完成的接口,已汇总至下述接口文档中,本地启动对应项目,通过接口文档访问查看效果。

https://apifox.com/apidoc/shared-86d9d3be-8a15-453f-85a6-4420180a915e

在线接口文档预览地址图片: