用户批量更新（User Update）

live-阿里云（Alibaba Cloud）

https://jingopenapi.jingsocial.com

POST

/v1/user/update

目前更新接口和创建接口为同一个，v2版本会区分开

接口描述：多身份字段批量用户创建/更新API

接口调用限制为：

每10秒500次；每天200000次

该接口单次用户数量上限为100个，Custom Field数量为50个

单次批量调用只能使用同一种身份标识

单次批量调用不能有重复的用户，需分次调用

Currently, the update interface and creation interface are the same, and the in v2 version they will be distinguished

Interface Description: Multi-identity fields batch user creation/update API

Interface calls are limited to:

500 times every 10 seconds; 200,000 times per day

The maximum number of single users for this interface is 100, and the number of Custom Fields is 50

A single batch call can only use the same identifier

Single batch call can not have duplicate users, need to be called in batches

请求参数

Header 参数

app_id

string

应用id

必需

默认值:

access_token

string

应用密钥

必需

默认值:

Body 参数application/json

array of:

identities

array [object {4}]

必需

type

string

必需

必传，身份字段类型，可传身份字段类型如：wechat_openid\wechat_unionid\mobile\email、omni_user_uuid\第三方固定为thirdparty_channel

（English）Required, identity field type, can assign identity field type such as wechat_openid\wechat_unionid\mobile\email, omni_user_uuid\third party fixed as thirdparty_channel

value

string

必需

必传，身份字段类型对应的值

（English）Required,The value corresponding to the identity field type

name

string

可选

非必传，身份字段类型对应的label名

（English）Not required. The label name corresponding to the identity field type

channel_uuid

string

可选

渠道uuid， type为thirdparty_channel时必填

（English）Channel uuid, required when type is thirdparty_channel

fields

object

可选

非必传，用于更新用户自定义字段

（English）Not required, used to update user custom fields

fieldcode1

string

可选

自定义字段code, 如 “industry”

（Eglish）Custom field code, such as "industry"

fieldcode2

string

可选

leads_info

object

可选

非必传，用于更新leads信息

（English）Not required, used to update leads information

stage_name

string

可选

assign_sale_uuid

string

可选

leads_updated_timestamp

string

可选

leads_remark

integer

可选

source_data

object

来源字段

可选

source_type

string

最新投放内容

可选

fields_source

object

可选

非必传,用户指定用户自定义字段的来源

source_type

enum<string>

可选

固定值 : thirdparty_custom_source

枚举值:

thirdparty_custom_source

source_value

string

第三方自定义

必需

示例

[ 

    { 

        "identities":[ 

            { 

                "type":"mobile", 

                "value":"15556348978", 

                "name":"手机号" 

            }, 

            { 

                "type":"email", 

                "value":"11223323@qq.com", 

                "name":"邮箱" 

            }, 

            { 

                "type":"wechat_openid", 

                "value":"oYGod1Sluj6AQDuQiwygTXJWQOdE", 

                "name":"微信公众号openid" 

            }, 

            { 

                "type":"wechat_unionid", 

                "value":"oLulZwTX2MQGmp9ZNvC6l7eo3BaU", 

                "name":"微信开放平台unionid" 

            }, 

            { 

                "type":"thirdparty_channel", 

                "value":"oLulZwTX2MQGmp9ZNvC6l7eo3BaU", 

                "channel_uuid":"原始渠道id" 

            }, 

            { 

                "type": "omni_user_uuid", 

                "value": " S9Cp23Np2gLQfSKtS7rpXd " 

            } 

        ], 

        "fields":{ 

            "fieldcode1":"value1", 

            "fieldcode2":"value2" 

        }, 

        "leads_info":{ 

            "stage_name":"已会面", 

            "assign_sale_uuid":"00be5680-8384-44d0-97e9-7ec08452831f", 

            "leads_updated_timestamp":"2022-03-0714:19:48", 

            "leads_remark":23 

        } 

    } 

]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://jingopenapi.jingsocial.com/v1/user/update' \
--header 'app_id;' \
--header 'access_token;' \
--header 'Content-Type: application/json' \
--data-raw '[ 

    { 

        "identities":[ 

            { 

                "type":"mobile", 

                "value":"15556348978", 

                "name":"手机号" 

            }, 

            { 

                "type":"email", 

                "value":"11223323@qq.com", 

                "name":"邮箱" 

            }, 

            { 

                "type":"wechat_openid", 

                "value":"oYGod1Sluj6AQDuQiwygTXJWQOdE", 

                "name":"微信公众号openid" 

            }, 

            { 

                "type":"wechat_unionid", 

                "value":"oLulZwTX2MQGmp9ZNvC6l7eo3BaU", 

                "name":"微信开放平台unionid" 

            }, 

            { 

                "type":"thirdparty_channel", 

                "value":"oLulZwTX2MQGmp9ZNvC6l7eo3BaU", 

                "channel_uuid":"原始渠道id" 

            }, 

            { 

                "type": "omni_user_uuid", 

                "value": " S9Cp23Np2gLQfSKtS7rpXd " 

            } 

        ], 

        "fields":{ 

            "fieldcode1":"value1", 

            "fieldcode2":"value2" 

        }, 

        "leads_info":{ 

            "stage_name":"已会面", 

            "assign_sale_uuid":"00be5680-8384-44d0-97e9-7ec08452831f", 

            "leads_updated_timestamp":"2022-03-0714:19:48", 

            "leads_remark":23 

        } 

    } 

]'

返回响应

🟢200成功

application/json

Body

code

string

必需

data

object

必需

success

array [object {3}]

必需

failure

array[string]

必需

msg

string

必需

request_id

string

必需

示例

{
    "request_id": "0cebb5c1dcfc4a13814bb28184d2c39b",
    "code": "10000",
    "msg": "success",
    "data": {
        "success": [
            {
                "leads_info": {
                    "stage_name": "已会面"
                },
                "identities": [
                    {
                        "name": "手机号",
                        "type": "mobile",
                        "value": "15112654318"
                    }
                ]
            }
        ],
        "failure": []
    }
}

🟢200失败

用户查询（User Query）

批量查询用户身份

用户批量更新（User Update）

目前更新接口和创建接口为同一个，v2版本会区分开#

Currently, the update interface and creation interface are the same, and the in v2 version they will be distinguished#

请求参数

示例代码

返回响应

目前更新接口和创建接口为同一个，v2版本会区分开

Currently, the update interface and creation interface are the same, and the in v2 version they will be distinguished