使用场景:
企业将自有系统中的客户行为事件导入兔展平台,与兔展平台内的客户进行统一识别与匹配
接口地址 /api/integrate/event/batchAdd
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 企业级接口,hearer必须携带X-Token
注意事项 对于企业业务系统、未接入斐波SDK的自有APP、小程序等产生的客户行为事件,如需导入兔展平台,需先在自定义事件中先进行定义。
#请求参数
###请求头参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
X-Token | 自建应用访问token | header | true | string |
###公共参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
data | 导入数据 | body | true | array | 事件 |
###事件 说明 用户标识匹配优先级:unionid > openid > identityId
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
identityId | unionid与openid都不存在则需生成uuid作为临时用户身份标识 | body | false | string | |
thirdId | 客户ID | body | false | string | |
openid | 微信openid | body | false | string | |
unionid | 微信unionid | body | false | string | |
phone | 手机 | body | false | string | |
time | 事件时间戳 | body | false | long | |
uuid | 随机字符串 | body | false | string | |
eventId | 事件ID,兔展平台获取 | body | false | string | |
intid | 场景互动ID | body | false | string | |
eventargs | 事件参数,必有系统预设参数,可能包含自定义参数 | body | false | map |
###请求示例
{
"data":[{
"audienceUserId":"1",
"openid":"h45bef43t45hg34h3g2",
"unionid":"d3f4g2ferg3t2ff2g4g2f21f2",
"phone":"15000000000",
"time":1600912805,
"uuid":"asd123",
"eventId":"e1",
"intid":"jkl789",
"eventargs":{
"title":"测试标题"
}
}]
}
#响应参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
code | 状态码 | body | true | string | |
errorCode | 异常码 | body | true | string | |
msg | 描述 | body | true | string |
###响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
###响应示例
{
"code": "200",
"errorCode": "SUCCESS",
"msg": "ok"
}