更新应用suite_ticket
教育号每十分钟向应用推送一次ticket变更,应用需要记录最新ticket,用于后续接口调用。
请求方式:POST(HTTPS)
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99e54c0fxxxx]]></SuiteId>
<InfoType> <![CDATA[suite_ticket]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<SuiteTicket><![CDATA[asdfasfdasdfasdf]]></SuiteTicket>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
InfoType | suite_ticket |
TimeStamp | 时间戳 |
SuiteTicket | Ticket内容,最长为512字节 |
响应返回: "success" 字符串
应用授权通知(安装)
当机构管理员在通过应用市场或扫描二维码等方式将应用安装到所属机构时,教育号将会向应用推送通知。
请求方式:POST(HTTPS)
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe9xxx4c0f4c]]></ SuiteId>
<AuthCode><![CDATA[AUTHCODE]]></AuthCode>
<InfoType><![CDATA[create_auth]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
</xml>
服务商的响应必须在1000ms内完成,以保证用户安装应用的体验。建议在接收到此事件时,先记录下AuthCode,并立即回应平台,之后再做相关业务的处理。
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCode | 授权的auth_code,最长为512字节。用于获取机构的永久授权码。10分钟内有效 |
InfoType | create_auth |
TimeStamp | 时间戳 |
响应返回: "success" 字符串
变更应用授权(可见范围)
当机构管理员修改了应用在机构内的可见范围时,教育号将会向应用推送通知,应用需要调用获取机构授权信息接口获取最新授权信息。
请求方式:POST(HTTPS)
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<InfoType><![CDATA[change_auth]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
</xml>
服务商的响应必须在1000ms内完成,以保证用户变更授权的体验。建议在接收到此事件时,立即回应,之后再做相关业务的处理。
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
InfoType | change_auth |
TimeStamp | 时间戳 |
AuthCorpId | 授权方的corpid |
响应返回: "success" 字符串
取消应用授权(卸载)
当机构管理员从当前机构中卸载应用时,教育号将会向应用推送通知。
请求方式:POST(HTTPS)
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99e54cxxxx]]></ SuiteId>
<InfoType><![CDATA[cancel_auth]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<AuthCorpId><![CDATA[wxf8b4f85fxx794xxx]]></AuthCorpId>
</xml>
服务商的响应必须在1000ms内完成,以保证用户取消授权的体验。建议在接收到此事件时,立即回应,之后再做相关业务的处理。注意,服务商收到取消授权事件后,应当确保删除该机构所有相关的数据。
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
InfoType | cancel_auth |
TimeStamp | 时间戳 |
AuthCorpId | 授权方机构的CorpId |
响应返回: "success" 字符串