...
Markdown |
---|
**接口地址** `/api/integrate/event/batchAdd`
**请求方式** `POST`
**consumes** `["application/json"]`
**produces** `["application/json"]`
**接口描述** `企业级接口,hearer必须携带X-Token`,
#请求参数
***
###请求头参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| X-Token | 自建应用访问token | header | true | string | |
###公共参数
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| data | 导入数据 | body | true | array | [事件](#事件) |
###事件
**说明** 用户标识匹配优先级:unionid > openid > identityId
| 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
| ------ | ------ | ------ | ------ | ------ | ------ |
| identityId | unionid与openid都不存在则需生成uuid作为临时用户身份标识 | body | false | string | |
| audienceUserId | 客户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 | |
###请求示例
```json
{
"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 | |
###响应示例
```json
{
"code": "200",
"errorCode": "SUCCESS",
"msg": "ok"
}
```
|
...