家校通讯录回调通知
下列接口中 notify_url 代表开发者配置的回调服务 url
新增学生事件 (create_student)
当学校在家校通讯录中新增学生时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[create_student]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为create_student |
Id | 新增学生的家校通讯录userid |
响应返回: "success" 字符串
编辑学生事件 (update_student)
当学校在家校通讯录中更新学生信息或与之相关联的家长信息时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[update_student]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
<NewId><![CDATA[zhangsan2]]></NewId>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为update_student |
Id | 更新学生的家校通讯录userid |
NewId | 新的学生userid,只在userid被修改时回调 |
响应返回: "success" 字符串
删除学生事件 (delete_student)
当学校在家校通讯录中删除学生时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[delete_student]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为delete_student |
Id | 删除学生的家校通讯录userid |
响应返回: "success" 字符串
新增家长事件 (create_parent)
当学校在家校通讯录中新增家长时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[create_parent]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为create_parent |
Id | 新增家长的家校通讯录userid |
响应返回: "success" 字符串
编辑家长事件 (update_parent)
当学校在家校通讯录中更新家长信息时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[create_parent]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
<NewId><![CDATA[zhangsan2]]></NewId>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为update_parent |
Id | 更新家长的家校通讯录userid |
NewId | 新的家长userid,只在userid被修改时回调 |
响应返回: "success" 字符串
删除家长事件 (delete_parent)
当学校在家校通讯录中删除家长时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[delete_parent]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为delete_parent |
Id | 删除家长的家校通讯录userid |
响应返回: "success" 字符串
家长关注事件 (subscribe)
当家长关注家校通知时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[subscribe]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为subscribe |
Id | 家长的userid |
响应返回: "success" 字符串
家长取消关注事件 (unsubscribe)
当家长取消关注家校通知时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[unsubscribe]]></ChangeType>
<Id><![CDATA[zhangsan]]></Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为unsubscribe |
Id | 家长的userid |
响应返回: "success" 字符串
新增部门事件 (create_department)
当学校在家校通讯录中创建部门时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[create_department]]></ChangeType>
<Id>2</Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为create_department |
Id | 部门Id |
响应返回: "success" 字符串
更新部门事件 (update_department)
当学校在家校通讯录中更新部门时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[update_department]]></ChangeType>
<Id>2</Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为update_department |
Id | 部门Id |
响应返回: "success" 字符串
删除部门事件 (delete_party)
当学校删除家校通讯录部门时,回调此事件至第三方应用的指令回调URL。
请求方式:POST(HTTPS)
请求地址:https://notify_url?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=1403610513&nonce=380320359
请求包体:
<xml>
<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<InfoType><![CDATA[change_school_contact]]></InfoType>
<TimeStamp>1403610513</TimeStamp>
<ChangeType><![CDATA[delete_department]]></ChangeType>
<Id>1</Id>
</xml>
参数说明:
参数 | 说明 |
---|---|
SuiteId | 第三方应用的SuiteId |
AuthCorpId | 授权方的CorpId |
InfoType | 固定为change_school_contact |
TimeStamp | 时间戳 |
ChangeType | 固定为delete_department |
Id | 部门Id |
响应返回: "success" 字符串