新增/更新

  • 接口：common/userBindings/v2/batch
  • Method：POST
  • 数据格式：JSON
  • 限流信息：150次每天和50次每小时
  • 接口说明：
    • 用户绑定标准口, 用于用户和第三方平台绑定信息的新增及更新
    • 该接口根据 platform 和 userid 去判断进行新增还是更新
    • 当传入的 data 集合中存在多个 platform 时, 只会使用第一个存在的 platform, 并且后面的 vo 与第一个 platform 不相等, 则不会对这条数据进行同步
    • 当传入的 user_id 在用户表中不存在, 则不会对这条数据进行同步
    • 在整批数据中若由于某些原因导致几条数据处理失败，失败数据不会被同步，其他数据仍会正常同步
    • 单次数据量过大（超过200条）时会全部转为异步处理，具体参考回调示例
    • 多语言设置：请求头（Headers）中添加KEY为locale，VALUE取语言参数其中之一：zh_CN（中文简体）、en_US（英文）、ja_JP（日文）、zh_TW（中文繁体）的Header参数

请求参数

字段名称 字段类型 字段描述 是否必填
bizId String 业务唯一识别码 true
timestamp long 时间戳 true
data.code String platform + userid拼接 false
data.user_id Integer 第三方用户id true
data.platform String 平台 true
data.userid String 第三方用户编码 true
data.full_name String 用户显示名称 false
data.companyid String 第三方公司id true
data.enabled_flag String 启用标记(N或Y), 默认为Y false
data.description String 描述 false
data.supervisor_bind_id String 上级第三方id false
data.mobile String 手机号码 false
data.role String 角色 false
data.accesstoken String accesstoken false
data.refreshtoken String refreshtoken false
data.expires_in String 到期时间 false
data.username String 用户名 false
### 示例 
{
    "bizId": "2123",
    "timestamp": 1647401261000,
    "data": [
        {
            "user_id": 223562,
            "userid": 223562,
            "platform": "test",
            "department_bind": "test",
            "full_name": "test123",
            "companyid": "12322313",
            "company_id": 3809,
            "mobile": "123",
            "enabled_flag": "Y",
            "accesstoken": "abcd123中文!@#$",
            "refreshtoken": "1234",
            "role": "员工",
            "username": "test231"
        }
    ]
}

返回参数

字段名称 字段类型 字段描述
resCode String 状态码
resMsg String 描述
bizId String 业务唯一标识
data.validatorErrors String 错误信息
data.created String 新增数据信息
data.warnings.code String 警告数据编码
data.warnings.messages String 警告信息
data.dbErrors String 数据库错误信息
data.updated String 更新数据信息
### 示例 
{
    "resCode": 200000,
    "resMsg": "SUCCESS",
    "bizId": "80801fe9-1630-482e-adb7-19a7e3a49fc6",
    "data": {
        "validatorErrors": [],
        "created": "此次请求新建了0条数据",
        "warnings": [],
        "dbErrors": [],
        "updated": "此次请求更新了1条数据"
    }
}

results matching ""

    No results matching ""