该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小时,开发者需要进行缓存,不可频繁获取。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/get_suite_token
请求包体:
{
"suite_id":"wwddddccc7775555aaa" ,
"suite_secret": "ldAE_H9anCRN21GKXVfdAAAAAAAAAAAAAAAAAA",
"suite_ticket": "Cfp0_givEagXcYJIztF6sfbdmIZCmpaR8ZBsvJEFFNBrWmnD5-CGYJ3_NhYexMyw"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
suite_id | 是 | 第三方应用id或者代开发应用模板id。第三方应用以ww或wx开头应用id(对应于旧的以tj开头的套件id);代开发应用以dk开头 |
suite_secret | 是 | 第三方应用secret 或者代开发应用模板secret |
suite_ticket | 是 | 企业微信后台推送的ticket |
返回结果:
{
"errcode":0,
"errmsg":"ok",
"suite_access_token":"61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA",
"expires_in":7200
}
参数说明:
参数 | 说明 |
---|---|
suite_access_token | 第三方或者代开发应用access_token,最长为512字节 |
expires_in | 有效期(秒) |
注意:因历史原因,该接口在调用失败时才返回errcode。没返回errcode视为调用成功