第三方应用开发 服务端API 应用授权 接口调用 获取第三方应用凭证
获取第三方应用凭证
最后更新:2023/02/21
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取第三方应用凭证
最后更新:2023/02/21

该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视为调用成功

上一篇
通讯录权限体系
下一篇
获取预授权码