第三方应用开发 服务端API 通讯录管理 通讯录回调通知 部门通知事件
部门通知事件
最后更新:2022/08/05
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
部门通知事件
最后更新:2022/08/05

目录

  • 新增部门事件
  • 更新部门事件
  • 删除部门事件
  • 新增部门事件

     

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

     

    请求包体:
    xml请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54cxxxx]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a79xxxx]]></AuthCorpId>
    	<InfoType><![CDATA[change_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[create_party]]></ChangeType>
    	<Id>2</Id>
    	<Name><![CDATA[张三]]></Name>
    	<ParentId>1</ParentId>
    	<Order>1</Order>
    </xml>

    json请求示例:

    {
    	"SuiteId": "ww4asffe99e54cxxxx",
    	"AuthCorpId": "wxf8b4f85f3a79xxxx",
    	"InfoType": "change_contact",
    	"TimeStamp": 1403610513,
    	"ChangeType": "create_party",
    	"Id": 2,
    	"Name": "张三",
    	"ParentId": 1,
    	"Order": 1
    }

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_contact
    TimeStamp时间戳
    ChangeType固定为create_party
    Id部门Id
    Name部门名称,此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回真实Name字段,使用Id字段代替Name字段,后续第三方仅通讯录应用可获取;代开发自建应用需要管理员授权才返回;未返回name的情况页面需要通过通讯录展示组件来展示名字
    ParentId父部门id
    Order部门排序

    说明:

    • 由通讯录应用发起的新增部门触发的事件不回调给通讯录应用。
    • 对于通讯录编辑授权,部门属性只回调Id/ParentId两个个字段

    更新部门事件

     

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

    请求包体:
    xml请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54cxxxx]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a79xxxx]]></AuthCorpId>
    	<InfoType><![CDATA[change_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[update_party]]></ChangeType>
    	<Id>2</Id>
    	<Name><![CDATA[张三]]></Name>
    	<ParentId>1</ParentId>
    </xml>

    json请求示例:

    {
    	"SuiteId": "ww4asffe99e54cxxxx",
    	"AuthCorpId": "wxf8b4f85f3a79xxxx",
    	"InfoType": "change_contact",
    	"TimeStamp": 1403610513,
    	"ChangeType": "update_party",
    	"Id": 2,
    	"Name": "张三",
    	"ParentId": 1
    }

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_contact
    TimeStamp时间戳
    ChangeType固定为update_party
    Id部门Id
    Name部门名称,仅当该字段发生变更时传递。部门名称,此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回真实Name字段,使用Id字段代替Name字段,后续第三方仅通讯录应用可获取,第三方页面需要通过通讯录展示组件来展示名字
    ParentId父部门id,仅当该字段发生变更时传递。回收后普通第三方应用name变更不再回调

    说明:

    • 由通讯录应用发起的更新部门触发的事件不回调给通讯录应用。
    • 对于通讯录编辑授权,该事件只会在ParentId变更时触发,并且部门属性只回调Id/ParentId两个个字段

     

    删除部门事件

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

    请求包体:
    xml请求示例:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54cxxxx]]></SuiteId>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a79xxxx]]></AuthCorpId>
    	<InfoType><![CDATA[change_contact]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<ChangeType><![CDATA[delete_party]]></ChangeType>
    	<Id>2</Id>
    </xml>

    json请求示例:

    {
    	"SuiteId": "ww4asffe99e54cxxxx",
    	"AuthCorpId": "wxf8b4f85f3a79xxxx",
    	"InfoType": "change_contact",
    	"TimeStamp": 1403610513,
    	"ChangeType": "delete_party",
    	"Id": 2
    }

    参数说明:

    参数说明
    SuiteId第三方应用ID
    AuthCorpId授权企业的CorpID
    InfoType固定为change_contact
    TimeStamp时间戳
    ChangeType固定为delete_party
    Id部门Id

    说明: 由通讯录应用发起的删除部门触发的事件不回调给通讯录应用。

    上一篇
    成员通知事件
    下一篇
    标签通知事件