共享 Token 接口

本接口用于获取平台已开放共享权限的移动运营商访问 Token。客户无需直接维护运营商应用密钥，平台根据客户已授权的通道配置完成校验并向运营商申请 Token。

服务地址

https://api.example.com

HTTP（http://api.example.com）仅为存量兼容保留，不做自动跳转，新接入请使用 HTTPS。

接口信息

POST /openapi/v3/query/operator-token

请求头：Content-Type: application/json。

请求体：

参数	类型	说明
appId	string	平台分配的客户应用标识
chanKey	string	已开通共享 Token 权限的通道标识

请求示例：

{
  "appId": "example-app-id",
  "chanKey": "channel_010"
}

响应中的 data.accessToken 用于调用移动运营商 V5 接口。Token 的有效期以 data.tokenExpire 为准，请勿将 Token 写入代码仓库或日志。

响应示例： 失败时，接口返回的 data 为 {}，不是 null；例如 code=50 表示平台侧获取运营商 Token 失败。

{
  "code": 0,
  "message": "",
  "data": {
    "chanAlias": "中国移动物联网",
    "chanKey": "channel_010",
    "accessToken": "example-access-token",
    "tokenExpire": "2026-09-09 16:00:00"
  },
  "error": null
}

字段说明

参数	类型	说明
code	number	平台业务状态码，0 表示成功；50 表示平台侧获取运营商 Token 失败
message	string	错误或提示信息
data	object	成功时返回 Token 信息；失败时返回空对象 {}，不是 null
data.chanAlias	string	通道名称
data.chanKey	string	通道标识
data.accessToken	string	移动运营商接口访问 Token
data.tokenExpire	string	Token 过期时间
error	any	错误详情；无错误时通常为 null

调用示例

curl --request POST \
  --url https://api.example.com/openapi/v3/query/operator-token \
  --header 'Content-Type: application/json' \
  --data '{
    "appId": "example-app-id",
    "chanKey": "channel_010"
  }'

共享 Token 仅适用于已开通共享权限的通道。若通道未授权、客户应用标识与通道不匹配，或运营商 Token 获取失败，接口将返回失败信息。