自定义事件上报
最后更新：2024/05/28
自定义事件请求
调用方式
- 请求方式:
POST - 请求地址:
https://www.allapp.link/v2/event/srv-custom
请求头参数（Header）
| 参数 | 必须 | 值 | 说明 |
|---|---|---|---|
| Content-Type | 是 | application/json | 声明json格式 |
| Authorization | 是 | Bearer AppKey | AppKey 获取方式：访问密钥 |
请求内容参数（Body）
请求示例：
{
"project": "项目ID",
"request_id": "uuid",
"timestamp": 1696867200000,
"msg_signature": "请求签名",
"event": "自定义事件名称",
"user_data": {
"blackbox": "blackbox",
"user_id": "user_id"
},
"custom_data": [
{
"key": "自定义事件参数键1","value": "自定义事件参数值1"
},
{
"key": "自定义事件参数键2","value": "自定义事件参数值2"
}
]
}
参数说明
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| project | 是 | string | 智链Dashboard后台项目管理页中获取到的项目ID |
| request_id | 是 | string | 请求唯一id |
| timestamp | 是 | int64 | 当前时间戳(毫秒) |
| msg_signature | 是 | string | sha1(project+"_"+request_id+"_"+timestamp+"_"+AppSecret) AppSecret获取方法：AppSecret |
| event | 是 | string | 智链Dashboard后台[事件管理页]中定义的EVENT |
| user_data | 是 | object | 用户数据 |
| user_data.blackbox | 否 | string | blackbox, TurboLink定义的终端编码 |
| user_data.user_id | 是 | string | 用户id |
| custom_data | 否 | []object | 自定义事件数据参数键值对 |
| custom_data.key | 是 | string | 自定义事件参数键 |
| custom_data.value | 否 | string | 自定义事件参数值 |
返回示例
{
"code": 200,
"msg": "请求成功",
"data": {
"link_hash_id": "MtwUCV4LxYd7L7V5EUkVom",
"blackbox": "cob6i06rdj7vtortk6o0743701"
}
}
返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int32 | 返回状态码 200为成功返回 |
| msg | string | 返回状态码信息 |
| data | object | 返回内容 |
| data.link_hash_id | string | 归因中的所属链接hash |
| data.blackbox | string | blackbox, TurboLink定义的终端编码 |
返回编码(code)说明
| 返回编码 | 说明 |
|---|---|
| 200 | 成功 |
| 20000 | 通过系统检索错误 |
| 20001 | 请求过多 |
| 10104 | 参数错误 |
| 10105 | AppKey验证错误,请检查AppKey在HTTPS请求里的Headers设置 AppKey使用 |
| 10106 | AppSecret验证错误，请参考 msg_signature 字段说明 |
| 10107 | API重复请求，上报事件时每次的RequestID都需要不一样 |
| 10201 | 上报的事件不存在，需要到Dashboard添加自定义事件 |
| 10501 | blackbox不存在 |
| 10502 | 设备不存在 |
| 10601 | 没有找到与用户关联的设备信息 |