批量上报行为事件

云端 Mock

https://m1.apifoxmock.com/m1/8276902-0-7755968

POST

/api/v1/events/batch

客户端或 BFF 批量上报。每条事件含 event_type、occurred_at、properties；
context 为公共属性，服务端可与单条事件合并后标准化并投递 Kafka。

前端：发送请求即可，无需解析响应 body（成功为 204，无内容）。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Header 参数

Body 参数application/json必填

示例

首页推荐模块曝光推荐商品点击推荐来源加购成功

{
    "context": {
        "user_id": "U10001",
        "device_id": "OAID-xxxx",
        "shop_id": "S20002",
        "app_version": "8.12.0",
        "os": "Android",
        "network_type": "WIFI",
        "city_id": "440100"
    },
    "events": [
        {
            "event_type": "recommend_home_impression",
            "occurred_at": 1715769600000,
            "properties": {
                "rec_session_id": "rec-batch-abc-001",
                "item_ids": "1001,1002,1003",
                "position_indexes": "1,2,3",
                "module_position": "首页推荐商品区"
            }
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

首页推荐模块曝光推荐商品点击推荐来源加购成功

curl --location 'https://m1.apifoxmock.com/m1/8276902-0-7755968/api/v1/events/batch' \
--header 'apifoxToken: t94DGHiwKNFzMweq1wQUI' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "context": {
        "user_id": "U10001",
        "device_id": "OAID-xxxx",
        "shop_id": "S20002",
        "app_version": "8.12.0",
        "os": "Android",
        "network_type": "WIFI",
        "city_id": "440100"
    },
    "events": [
        {
            "event_type": "recommend_home_impression",
            "occurred_at": 1715769600000,
            "properties": {
                "rec_session_id": "rec-batch-abc-001",
                "item_ids": "1001,1002,1003",
                "position_indexes": "1,2,3",
                "module_position": "首页推荐商品区"
            }
        }
    ]
}'

返回响应

🟢204

已受理，无响应体。后端异步校验与投递；客户端不必读取 body。

该响应没有 Body

🟠400

🟠401

🟠413

🟠429

修改于 2026-05-15 07:49:16

EventBatchRequest