第三方应用开发 服务端API 家校沟通 家校通讯录变更回调 家校通讯录批量变更事件
家校通讯录批量变更事件
最后更新:2022/12/21
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
家校通讯录批量变更事件
最后更新:2022/12/21

当学校在家校通讯录中,“成员变更”或者“部门变更”时,若同一个学校短时间内触发多个变更事件,为了提高回调效率,则会将这些变更合并为一个批量的事件回调此到第三方应用/套件的指令回调URL。

xml请求示例:

<xml> 
  <SuiteId>wwSuiteId</SuiteId>  
  <AuthCorpId>wxAuthCorpId</AuthCorpId>  
  <InfoType>change_school_contact_batch</InfoType> 
  <TimeStamp>1403610513</TimeStamp>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType>create_student</ChangeType>  
    <Id>zhangsan</Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType>update_student</ChangeType>  
    <Id>zhangsan</Id> 
	<NewId><![CDATA[zhangsan2]]></NewId>
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[delete_student]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[create_parent]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[update_parent]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
	<NewId><![CDATA[zhangsan2]]></NewId>
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[delete_parent]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[subscribe]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[unsubscribe]]></ChangeType>  
    <Id><![CDATA[zhangsan]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[create_department]]></ChangeType>  
    <Id><![CDATA[1]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[update_department]]></ChangeType>  
    <Id><![CDATA[1]]></Id> 
  </ChangeList>  
  <ChangeList> 
    <TimeStamp>1403610513</TimeStamp>  
    <ChangeType><![CDATA[delete_department]]></ChangeType>  
    <Id><![CDATA[1]]></Id> 
  </ChangeList> 
</xml>

参数说明:

参数说明
SuiteId第三方应用ID
AuthCorpId授权企业的CorpID
InfoType固定为change_school_contact_batch
TimeStamp最终回调的时间戳
ChangeList变更列表。目前最大支持合并1000条,后续可能会根据情况调整,以实际收到的数据为准。


ChangeList说明:

参数说明
ChangeType此处固定为create_student
Id学生的家校通讯录userid或者家长的id或者家校通讯录部门id
NewId当ChangeType为update_student或者update_parent时,变更后的学生的家校通讯录userid或者家长的id
TimeStamp产生变更的时间戳
上一篇
部门变更事件
下一篇
获取老师直播ID列表