获取增量通讯录

接口描述：接入服务提供给对接的外部应用服务调用，获取指定组织的通讯录增量变更信息。
请求地址：https://service.cheng-xun.cn/api/apps/address-book/v1.0/changes/{version}?access_token={access_token}
请求方式：GET

注意事项：

对接应用的服务器端在接收到数据时，需要先处理Add，再处理Update。如果收到50702的错误码，说明差异太多，请做一次全量同步通讯录。

返回响应

🟢200成功

application/json

Body

version

integer

版本信息

必需

当前通讯录版本号，后续用该版本号获取增量变量，对应增量更新中的version。

enterprise_id

integer

组织ID

必需

enterprise

object

组织信息

必需

如果组织基本信息变更会返回结果，否则为null

integer

组织ID

必需

name

string

组织名称

必需

version

integer

当前通讯录版本号

必需

group_enterprise_id

integer

集团id

必需

short_name

string

组织名称简称

必需

enterprise_type

integer

类型

必需

0:组织1:政府事业单位2:其他

logo_file_path

null

组织图标

必需

added_sectors

array [object {14}]

新增的部门

必需

integer

组织部门id

可选

name

string

部门名称

可选

parent_id

integer

父节点id

可选

当parent_id为-1时，表明是顶层节点

group_enterprise_id

integer

集团id

可选

enterprise_id

integer

组织id

可选

enterprise_flag

integer

类型

可选

0: 部门; 1: 组织;2: 集团企业

show_order

integer

显示顺序

可选

show_path

string

部门显示路径

可选

从根部门(不包括组织节点)开始，如“总部->人力资源”

tree_code

string

部门树代码

可选

使用“|”串联父级部门id，最后的是当前部门id，如“1|12|”

remote_reference_id

null

远程引用id

可选

short_name

string

简称

必需

name_first_letter

string

部门首字母缩写

可选

name_full_pinyin

string

部门首字母缩写

可选

data_status

integer

是否可用

必需

0-可用 1-不可用

updated_sectors

array [object {14}]

更新的部门

必需

integer

组织部门id

可选

name

string

部门名称

可选

parent_id

integer

父节点id

可选

group_enterprise_id

integer

集团id

可选

enterprise_id

integer

组织id

可选

enterprise_flag

integer

类型

可选

0: 部门; 1: 组织;2: 集团企业

show_order

integer

显示顺序

可选

show_path

string

部门显示路径

可选

从根部门(不包括组织节点)开始，如“总部->人力资源”

tree_code

string

部门树代码

可选

使用“|”串联父级部门id，最后的是当前部门id，如“1|12|”

remote_reference_id

null

远程引用id

可选

short_name

string

简称

必需

name_first_letter

string

部门首字母缩写

可选

name_full_pinyin

string

部门首字母缩写

可选

data_status

string

是否可用

必需

0--可用 1--不可用

deleted_sectors

array[integer]

删除部门ID列表

必需

upsert_staffs

array [object {23}]

插入或更新的员工

必需

integer

用户的通讯录id

可选

sex

string

性别

可选

性别：男，女，暂无

name

string

名称

可选

phone

null

手机号码

可选

null

邮箱

可选

account_id

string

帐号id

可选

唯一标识用户

group_enterprise_id

integer

集团id

可选

enterprise_id

integer

组织id

可选

name_first_letter

string

姓名首字母缩写

可选

name_first_pinyin

string

姓氏全拼

可选

name_full_pinyin

string

姓名全拼

可选

job_number

string

工作号码

可选

mobile_number

string

电话号码

可选

other_mobile_number1

null

其他手机1

可选

other_mobile_number2

null

其他手机2

可选

office_address

null

办公地址

可选

remote_reference_id

null

远程引用id

可选

position

string

职位

必需

position_option_id

string

职位ID

必需

职位唯一标识

position_level

string

职级

必需

head_portrait_small_url

string

头像缩略图

必需

head_portrait_hq_url

string

头像高清图

必需

sector_staffs

array [object {2}]

员工所属部门

可选

deleted_staffs

array[integer]

删除员工ID列表

必需

示例

{
    "version": 653833347104768,
    "enterprise_id": 652267137875968,
    "enterprise": {
        "id": 652267137875968,
        "name": "二七一十四",
        "version": 654022299480064,
        "group_enterprise_id": 652267137875968,
        "short_name": "十四",
        "enterprise_type": 0,
        "logo_file_path": null
    },
    "added_sectors": [
        {
            "id": 653994413223936,
            "name": "财务部",
            "parent_id": 652267137875968,
            "group_enterprise_id": 652267137875968,
            "enterprise_id": 652267137875968,
            "enterprise_flag": 0,
            "show_order": -3,
            "show_path": "财务部",
            "name_first_letter": "CWB",
            "name_full_pinyin": "CAIWUBU",
            "tree_code": "652267137875968|653994413223936|",
            "remote_reference_id": null
        }
    ],
    "updated_sectors": [
        {
            "id": 653994413223936,
            "name": "生产部",
            "parent_id": 652267137875968,
            "group_enterprise_id": 652267137875968,
            "enterprise_id": 652267137875968,
            "enterprise_flag": 0,
            "show_order": -3,
            "show_path": "生产部",
            "name_first_letter": "SCB",
            "name_full_pinyin": "生产部",
            "tree_code": "652267137875968|653994413223936|",
            "remote_reference_id": null
        }
    ],
    "deleted_sectors": [
        653994779326464
    ],
    "upsert_staffs": [
        {
            "id": 653994101303296,
            "account_id": "70238934839742",
            "name": "李明",
            "sex": "暂无",
            "phone": null,
            "email": null,
            "group_enterprise_id": 652267137875968,
            "enterprise_id": 652267137875968,
            "name_first_letter": "",
            "name_first_pinyin": "",
            "name_full_pinyin": "",
            "job_number": "1234",
            "mobile_number": "",
            "other_mobile_number1": null,
            "other_mobile_number2": null,
            "office_address": null,
            "sector_staffs": [
                {
                    "sector_id": 652267137875968,
                    "show_order": -4
                }
            ],
            "remote_reference_id": null
        }
    ],
    "deleted_staffs": [
        653994688073728
    ]
}

接口描述：接入服务提供给对接的外部应用服务调用，获取指定组织的通讯录增量变更信息。
请求地址：https://service.cheng-xun.cn/api/apps/address-book/v1.0/changes/{version}?access_token={access_token}
请求方式：GET

对接应用的服务器端在接收到数据时，需要先处理Add，再处理Update。如果收到50702的错误码，说明差异太多，请做一次全量同步通讯录。

请求参数

示例代码

返回响应

获取增量通讯录

接口描述：接入服务提供给对接的外部应用服务调用，获取指定组织的通讯录增量变更信息。请求地址：https://service.cheng-xun.cn/api/apps/address-book/v1.0/changes/{version}?access_token={access_token}请求方式：GET#

对接应用的服务器端在接收到数据时，需要先处理Add，再处理Update。 如果收到50702的错误码，说明差异太多，请做一次全量同步通讯录。#

请求参数

示例代码

返回响应

接口描述：接入服务提供给对接的外部应用服务调用，获取指定组织的通讯录增量变更信息。
请求地址：https://service.cheng-xun.cn/api/apps/address-book/v1.0/changes/{version}?access_token={access_token}
请求方式：GET

对接应用的服务器端在接收到数据时，需要先处理Add，再处理Update。如果收到50702的错误码，说明差异太多，请做一次全量同步通讯录。