第 14 章 导出和导入开发人员门户
作为 3scale API 供应商,您可以导出和导入开发人员门户,以满足以下目的:
- 创建备份.
- 将开发人员门户保留在外部存储库中,如 GitHub。
- 将开发人员门户与其他应用程序集成.
使用 Developer Portal API 作为内容管理系统(CMS)来导入和导出 Development Portal 内容。为此,请执行以下步骤来生成具有足够权限的密钥,以使用开发人员门户 API。
流程
- 导航到 Account settings > Personal > Tokens,再点 Add Access Token。
- 将访问令牌命名为,并检查 Developer Portal API。
选择权限:
- Read only 仅允许检索开发人员内容门户内容。
- 读和写 允许检索和恢复开发人员门户内容。
- 单击 Create Access token。
- 复制并存储显示的令牌信息。
检查在左侧面板中导航到 Integrate > 3scale API Docs 的端点列表。然后,向下滚动到 Developer Portal API。使用生成的令牌来调用每个端点,并根据您的需要填写字段。
开发者门户 API 端点注意事项
3scale 2.14 提供的 Developer Portal API 与之前的版本不兼容。另外,从 3scale 2.14 开始,JSON 是唯一兼容所有请求和响应的数据格式。
对于每个端点,您可以执行以下操作:
-
GET来读取和列出资源。 -
POST用于创建和添加资源。 -
PUT来修改资源。 -
DELETE删除资源。
注意
-
无法删除内置对象。使用
type=builtin_page参数调用GET /admin/api/cms/templates端点,以获取内置页面的列表和type=builtin_partial参数,以获取内置部分的列表。 - 要进行完整备份,您必须调用每个内容。没有 API 端点可以下载包含所有文件的完整存档。
-
如果未发送
内容,则不会返回已发布或草案内容。相反,它会返回一个摘要,其中包含模板名称和部分的信息,因为内容太长。
使用每个端点中列出的详情,在执行后优化其输出。对于列出的参数,请考虑以下几点:
- 所有端点都拒绝不支持的参数;如果发送不支持的参数,则请求将被取消。
-
GET /admin/api/cms/templates端点接受content参数。默认情况下,它返回 Developer Portal 模板列表。要也获得发布和草稿内容,请使用content=true参数。 -
GET /admin/api/cms/templates端点接受type和section_id参数来过滤结果。 -
GET /admin/api/cms/sections端点接受parent_id参数来过滤结果。 -
GET /admin/api/cms/files端点接受section_id参数来过滤结果。