易源OAuth2子授权

官方自营

易源OAuth2子授权，可通过应用appid创建无数个子授权access_token，这样在客户端可以使用access_token访问具备权限的接口，不再需要在客户端中放置appid和secret，提高安全性。

OAuth2 子授权 appid

已选规格

￥1.00元

自购买起有效期 12 个月

专用资源包

支持通用资源包：充值通用资源包后可直接调用含本接口在内的全站付费接口，无需单独购买专用资源包去充值 ›

创建子授权

接入点说明

根据客户系统的out_code，创建对应的子授权access_token，可对子授权的有效时间、访问IP、访问接口、并发、流量等做控制。
1:如果已有正常，则直接返回
2:如果已有的失效了，则改变token，设置新的过期时间再返回

接口地址

https://route.showapi.com/2141-1?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
content-type	String	application/x-www-form-urlencoded	否

Post 表单

参数名称	类型	示例值	必须	描述
out_code	String	myoutcode	是	子授权的唯一编码，通常对应于客户端系统中的的用户id。
rate	Number	3	否	每秒调用并发数。不传值或空串时默认为3。
ip_white_list	String	-	否	ip白名单，例如8.8.8.8,9.9.9.9 白名单列表以半角逗号分隔。一共可以建20个ip。不传值或空串表示不设置。
expires_in	Number	7200	否	此token的过期时间，单位秒。如果不传，默认7200秒，也就是2小时。
permission_list	String	6-1,32-*	否	此token可访问的api-point格式的列表，中间用半角逗号分隔。如果授权某个接口下的所有接入点，可以用32-*这样的格式。最多100个apiCode-pointCode授权对象。如果此字段为空串，则可以访问所有接口（在应用app可调用的权限以内）。
grant_type	String	Client Credentials	否	采用Client Credentials方式，即应用公钥、密钥方式获取Access Token。目前仅支持Client Credentials方法。
remark	String	-	否	此token的备注。

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://route.showapi.com/2141-1?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "out_code=myoutcode&rate=3&ip_white_list=&expires_in=7200&permission_list=6-1%2C32-*&grant_type=Client%20Credentials&remark="

返回示例

JSON

{
  "showapi_res_error": "",
  "showapi_res_id": "3acf476dcf214883856f404c73cb54a3",
  "showapi_res_code": 0,
  "showapi_res_body": {
     "item": {
      "permission_list": "6-1,32-*,",
      "expires_in": 7137,
      "end_time": "2019-10-22 00:35:15",
      "access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
      "rate": 3,
      "appid": 258,
      "out_code": "myoutcode",
      "ip_white_list": ""
    },
    "remark": "",
    "ret_code": 0
  }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

{
  "mcpServers": {
    "showapi-mcp-2141": {
      "url": "http://www.showapi.com.cn/mcp/2141/{your_appKey}"
    }
  }
}

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON