Skip to content

同步用户变更

适用版本>=v7.0.2508.20250821

接口说明:同步用户变更

标签组织架构变更

请求说明

字段
请求地址
配置域名+/openapi+/v7/users/changes
HTTP 方法
GET
接口描述
同步用户变更,由于会有数据清理,只保留最近[x]天的数据变更记录,[x]可以动态调整,注意:可能同步到重复的变更记录,需要调用方单独处理
签名方式
KSO-1(配置域名+/openapi不参与签名)
限频策略
权限要求
查询和管理通讯录信息(应用授权) kso.contact.readwrite
查询通讯录信息(应用授权) kso.contact.read

请求头 (Headers)

属性名类型是否必填描述可选值
X-Kso-Date
stringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT-
X-Kso-Authorization
stringKSO-1 签名值,详见《签名方法》-
Authorization
string授权凭证,格式为:Bearer {access_token}-

查询参数 (Query)

属性名类型是否必填描述可选值
last_change_time
integer上次变更时间,表示从上次的变更点继续同步,需要由调用方维护传入-
page_size
integer分页大小,默认为:20,最大值:200-
page_token
string分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果-

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

json
{
  "data": {
    "items": [
      {
        "change_time": 0,
        "change_type": "string",
        "id": "string",
        "user_id": "string"
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "msg": "string"
}