获取第三方应用凭证

POST

/cgi-bin/service/get_suite_token

服务端API智慧硬件开发第三方应用开发

该API用于获取第三方应用凭证（suite_access_token）。

由于第三方服务商可能托管了大量的企业，其安全问题造成的影响会更加严重，故API中除了合法来源IP校验之外，还额外增加了suite_ticket作为安全凭证。
获取suite_access_token时，需要suite_ticket参数。suite_ticket由企业微信后台定时推送给“指令回调URL”，每十分钟更新一次，见推送suite_ticket。
suite_ticket实际有效期为30分钟，可以容错连续两次获取suite_ticket失败的情况，但是请永远使用最新接收到的suite_ticket。
通过本接口获取的suite_access_token有效期为2小时，开发者需要进行缓存，不可频繁获取。

注意：因历史原因，该接口在调用失败时才返回errcode。没返回errcode视为调用成功

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/service/get_suite_token' \
--header 'Content-Type: application/json' \
--data-raw '{"suite_id":"wwddddccc7775555aaa","suite_secret":"ldAE_H9anCRN21GKXVfdAAAAAAAAAAAAAAAAAA","suite_ticket":"Cfp0_givEagXcYJIztF6sfbdmIZCmpaR8ZBsvJEFFNBrWmnD5-CGYJ3_NhYexMyw"}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "suite_access_token": "61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA",
    "expires_in": 7200
}

请求参数

Body 参数application/json

suite_ticket

string

必需

企业微信后台推送的ticket

suite_secret

string

应用secret

必需

suite_id

string

必需

以ww或wx开头应用id（对应于旧的以tj开头的套件id）

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

suite_access_token

string

可选

第三方应用access_token,最长为512字节

expires_in

integer <int32>

有效期（秒）

可选

修改于 2022-12-05 04:00:52

明文corpid转换为加密corpid

获取预授权码