应用管理回调通知

下列接口中 notify_url 代表开发者配置的回调服务 url

推送suite_ticket

平台服务器会定时(每十分钟)推送 ticket。ticket 会实时变更,并用于后续接口的调用。

请求方式:POST(HTTPS
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

请求包体:

    <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
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

请求包体:

    <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
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

请求包体:

    <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
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

请求包体:

    <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" 字符串

2019 Tencent SmartCampus. all right reserved,powered by Gitbooktime: 2021-03-24 08:03:20

results matching ""

    No results matching ""

    results matching ""

      No results matching ""