导入到你自己的 Apifox 项目

目标:把 CokeAPI 完整文档(接口 + 文章 + 图片)上传到你的 Apifox,并发布公开文档站。

准备好的材料

材料地址
上传包目录https://doc.cokeapi.com/apifox-upload/
上传包 ziphttps://doc.cokeapi.com/apifox-upload.zip
OpenAPI(完整)https://doc.cokeapi.com/apifox-upload/openapi.json
OpenAPI(精简核心)https://doc.cokeapi.com/openapi.json
导入说明https://doc.cokeapi.com/apifox-upload/IMPORT.md
文档站(可先用)https://doc.cokeapi.com/

本地路径:brand/apifox/apifox-upload/

步骤 1:新建项目

  1. 打开 Apifox → 登录
  2. 新建项目,名称 CokeAPI
  3. 类型选 HTTP

步骤 2:导入接口

  1. 项目设置 → 导入数据OpenAPI / Swagger
  2. URL 导入

https://doc.cokeapi.com/apifox-upload/openapi.json

  1. 建议勾选「定时导入」,文档站更新后可同步
  2. 导入后检查左侧接口树与环境 Base URL:https://www.cokeapi.com/v1

步骤 3:导入文章(Markdown)

  1. 下载 zip 并解压,或打开本地 brand/apifox/apifox-upload/markdown/
  2. 在 Apifox 按文件夹建目录(与 zip 内一致),例如:

- 00-CokeAPI官方指南

- 00-开始

- 中转站基本介绍

- 各种插件/软件使用教程

- …

  1. 每个 .md → 新建 Markdown 文档 → 粘贴全文

图片已是 https://doc.cokeapi.com/images/...,在 Apifox 里可直接显示

  1. 建议先贴官方指南,再贴迁移教程

步骤 4:发布

  1. Apifox → 分享 / 发布文档
  2. 得到 https://xxxx.apifox.cn/
  3. 把链接发给运维,可将站点导航「文档」切到该地址

步骤 5:调试环境(可选)

变量
baseUrlhttps://www.cokeapi.com/v1
apiKeysk-你的令牌

请求头:Authorization: Bearer {{apiKey}}

注意