开放平台接口文档

基于 OAuth2 客户端凭证模式调用开放 API。请先在开发后台创建应用并申请作用域，再使用 Client ID 与 Secret 换取访问令牌。

鉴权与令牌

开放平台使用 OAuth2 标准协议。服务端集成请使用 client_credentials 模式换取访问令牌；令牌默认有效期 2 小时，请勿在客户端代码中暴露 Secret。

1. 创建应用在开放平台开发后台创建应用，获取 Client ID 与 Client Secret。

2. 申请作用域按业务需要申请 Scope，运营审核通过后接口自动开通。

3. 换取令牌调用令牌端点获取 access_token，并在请求头中携带 Bearer 令牌。

获取访问令牌

POST /oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
client_id=YOUR_CLIENT_ID
client_secret=YOUR_CLIENT_SECRET
scope=order.read

调用示例

所有开放接口均通过 API 网关统一访问，请在请求头携带访问令牌。

网关

curl

curl -X GET "https://api.example.com/openplatform/api/orders" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Accept: application/json"

提示：调用方需使用与 scope 匹配的访问令牌。若返回 401/403，请检查令牌是否过期以及应用是否已获得对应作用域。

作用域与接口

共 0 个开放作用域，0 个开放接口。

正在加载接口目录…