使用场景:

企业将自有系统中的客户标签导入兔展平台,与兔展平台内的客户进行统一识别与匹配


接口地址 /api/integrate/audience/tag/batchAdd

请求方式 POST

consumes ["application/json"]

produces ["application/json"]

接口描述 企业级接口,hearer必须携带X-Token

应用权限 客户->客户标签

#请求参数


###请求头参数

参数名称参数说明请求类型是否必须数据类型schema
X-Token自建应用访问tokenheadertruestring

###公共参数

参数名称参数说明请求类型是否必须数据类型schema
publicParams导入配置bodytrueobject客户标签导入配置
data导入数据,每次最大500条bodytruearray客户标签

###客户标签导入配置

参数名称参数说明请求类型是否必须数据类型schema
isMatching是否进行客户匹配(true, false)bodytrueboolean
matchingType匹配方式(1: 精准匹配, 2: 模糊匹配)bodyfalseint
identifyWay模糊匹配 必传->身份识别方式(1: 开放平台unionid>公众号openid>手机号>客户ID, 2: 客户ID>手机号>公众号openid>开放平台unionid)bodyfalseint
accurateMatchType精确匹配的应用类型(gzh: 公众号, workwechat: 企业微信, YOUZAN: 有赞, EZR: 驿客, contentminiapp: 小程序, contenthome: 小程序首页)bodyfalseString
accurateMatchValue精确匹配的应用IDbodyfalseString
optType导入方式(add: 新增, delete: 删除)bodytrueString

###客户标签

参数名称参数说明请求类型是否必须数据类型schema
identityType精确匹配 必填,身份识别类型(phone: 手机号码, id: 客户ID, openid: 公众号openid, unionid: 开放平台unionid)bodyfalsestring
thirdId客户IDbodyfalsestring
openid公众号openidbodyfalsestring
unionid开放平台unionidbodyfalsestring
phone手机bodyfalsestring
tags客户标签,多个用,号隔开bodyfalsestring

###请求示例

{
	"publicParams":{
		"isMatching":true,
		"matchingType":2,
		"identifyWay":1,
		"optType":"add"
	},
	"data":[{
		"thirdId":"1",
		"tags":"tag1,tag2"
	}]
}

#响应参数


参数名称参数说明请求类型是否必须数据类型schema
code状态码bodytruestring
errorCode异常码bodytruestring
msg描述bodytruestring
data导入批次ID,用来查询导入结果,查询数据导入结果bodytruelong

###响应状态 | 状态码 | 说明 | schema | | ------ | ------ | ------ | | 200 | OK | | | 201 | Created | | | 401 | Unauthorized | | | 403 | Forbidden | | | 404 | Not Found | |

###响应示例

{
    "code": "500126",
    "errorCode": "IMPORT_DATA_ERROR",
    "msg": "导入失败",
    "data": 15314513451345123
}


  • 无标签