1. events
三只熊科技
  • 笨熊千人千面 - 首页推荐埋点上报
    • events
      • 批量上报行为事件
        POST
    • 数据模型
      • EventBatchRequest
      • EventContext
      • BehaviorEvent
      • EventCommon
      • RecommendHomeImpressionEvent
      • RecommendHomeClickEvent
      • RecommendConversionEvent
      • PropsRecommendHomeImpression
      • PropsRecommendHomeClick
      • PropsRecommendConversion
  1. events

批量上报行为事件

云端 Mock
https://m1.apifoxmock.com/m1/8276902-0-7755968
云端 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: ********************
or
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
Built with