在企业微信第三方应用开发中, 由于第三方服务商可能托管了大量的企业,其安全问题造成的影响会更加严重,故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
请求包体:
[C#] 纯文本查看 复制代码
{
"suite_id":"wwddddccc7775555aaa" ,
"suite_secret": "ldAE_H9anCRN21GKXVfdAAAAAAAAAAAAAAAAAA",
"suite_ticket": "Cfp0_givEagXcYJIztF6sfbdmIZCmpaR8ZBsvJEFFNBrWmnD5-CGYJ3_NhYexMyw"
}
请求参数说明:
参数 | 是否必填 | 说明 | suite_id | 是 | 以ww或wx开头应用id(对应于旧的以tj开头的套件id) | suite_secret | 是 | 应用secret | suite_ticket | 是 | 企业微信后台推送的ticket |
接口返回结果:
[C#] 纯文本查看 复制代码
{
"errcode":0 ,
"errmsg":"ok" ,
"suite_access_token":"61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA",
"expires_in":7200
}
返回结果参数说明:
参数 | 说明 | suite_access_token | 第三方应用access_token,最长为512字节 | expires_in | 有效期(秒) |
通过本接口获取的suite_access_token有效期为2小时,开发者需要进行缓存,不可频繁获取。
|