[TOC]
授权成功通知
从企业微信应用市场发起授权时,企业微信后台会推送授权成功通知。
从第三方服务商网站发起的应用授权流程,由于授权完成时会跳转第三方服务商管理后台,因此不会通过此接口向第三方服务商推送授权成功通知。
请求方式:POST(HTTPS)
请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
1403610513
服务商的响应必须在1000ms内完成,以保证用户安装应用的体验。建议在接收到此事件时,先记录下AuthCode,并立即回应企业微信,之后再做相关业务的处理。
参数说明:
参数
说明
SuiteId
第三方应用的SuiteId
AuthCode
临时授权码,最长为512字节。用于获取企业永久授权码。10分钟内有效
InfoType
create_auth
TimeStamp
时间戳
变更授权通知
当授权方(即授权企业)在企业微信管理端的授权管理中,修改了对应用的授权后,企业微信服务器推送变更授权通知。
服务商接收到变更通知之后,需自行调用获取企业授权信息进行授权内容变更比对。
请求方式:POST(HTTPS)
请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
1403610513
服务商的响应必须在1000ms内完成,以保证用户变更授权的体验。建议在接收到此事件时,立即回应企业微信,之后再做相关业务的处理。
参数说明:
参数
说明
SuiteId
第三方应用的SuiteId
InfoType
change_auth
TimeStamp
时间戳
AuthCorpId
授权方的corpid
取消授权通知
当授权方(即授权企业)在企业微信管理端的授权管理中,取消了对应用的授权托管后,企业微信后台会推送取消授权通知。
请求方式:POST(HTTPS)
请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
1403610513
服务商的响应必须在1000ms内完成,以保证用户取消授权的体验。建议在接收到此事件时,立即回应企业微信,之后再做相关业务的处理。注意,服务商收到取消授权事件后,应当确保删除该企业所有相关的数据。
参数说明:
参数
说明
SuiteId
第三方应用的SuiteId
InfoType
cancel_auth
TimeStamp
时间戳
AuthCorpId
授权方企业的corpid