使用场景:
企业将自有系统中的客户导入兔展平台,与兔展平台内的客户进行统一识别与匹配
接口地址 /api/integrate/import/user/batchAdd
请求方式 POST
consumes ["application/json"]
produces ["*/*"]
接口描述 企业级接口,hearer必须携带X-Token
###请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
X-ComponentToken | 第三方平台访问token(第三方平台) | header | false | string | |
dto | dto | body | true | API导入 | API导入 |
###公共参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
data | API导入公共参数 | body | false | array | API导入用户信息 |
publicParams | API导入公共参数 | body | false | API导入客户档案配置参数 | API导入客户档案配置参数 |
###导入用户信息
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
address | 地址 | body | false | string | |
birthday | 生日 | body | false | string | |
identityId | 身份识别Id | body | false | string | |
identityType | 身份设别类型,若企业需要对现有客户追加一个身份类型,则使用此字段,若仅更新客户资料,可以不传此字段 | body | false | string | |
industry | 行业 | body | false | string | |
openid | 微信openid | body | false | string | |
payFeature | 消费特点 | body | false | string | |
phone | 手机 | body | false | string | |
realName | 真实姓名 | body | false | string | |
remark | 备注 | body | false | string | |
sex | 性别 男 /女 | body | false | string | |
tags | 运营标签,多个用,号隔开 | body | false | string | |
unionid | 微信unionid | body | false | string | |
userType | 用户类型 | body | false | string |
###导入用户与存量用户匹配规则参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
identifyWay | 模糊匹配 必传->身份识别方式 1.unionid>openid>手机号、 2.手机号>unionid>openid | body | false | integer(int32) | |
importMode | 匹配结果处理,1 完全导入 2 不完全导入 | body | true | integer(int32) | |
isMatching | 是否进行客户匹配:true or false | body | true | boolean | |
matchingType | 匹配方式 1, "精准匹配" 2, "模糊匹配" | body | false | integer(int32) |
###响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ApiResponse«API导入处理结果信息» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |