管理中心指南

接口管理

查看接口

管理者可在接口管理菜单查看 开发者创建 和 管理中心创建 的所有接口。 img

新增接口

创建 API 即录入 API 的定义,需要录入 API 的基本信息、定义对外请求、定义后端服务、定义返回结果,并申请发布上线供平台用户使用。

  • 新增接口步骤

1)基本信息包括 所属分组、 API 名称、是否租户鉴权。

  • 所属分组:新增接口时,需要先创建分组
  • API名称:API 名称需具有唯一性
  • 租户鉴权:若需租户鉴权,则还需填写参数位置和字段
  • 描述:API功能描述

img

2)定义对外请求包括 请求方法、请求路径、请求示例和参数定义。

  • 请求方法: PUT、GET、POST、DELETE、PATCH、或 HEAD
  • 请求路径:接口的请求路径
  • 请求示例:提供示例供开发者参考
  • 参数定义:定义您 API 的请求入参,包含参数名、参数位置、类型、是否必填、默认值、描述、示例等信息

img

3)定义后端服务包括 后端路径、后端超时设置和参数确认请求示例和参数定义。 img

4)定义返回结果包括 成功返回示例、失败返回示例以及返回参数定义。

img

新增接口完成后,可在接口详情查看接口定义,以及该接口授权了哪些应用。 img

接口发布与下线

当您完成API的创建后,您可以将 API 发布到测试或者线上。也可以将测试或者线上的 API 下线。

当您要发布某个 API 时,如果该 API 在测试或者线上已经有版本在运行,您的此次发布将使测试或者线上的该 API 被覆盖,实时生效。

接口授权 支持将接口授权给平台的应用,授权后该应用可请求接口服务 img

results matching ""

    No results matching ""