上报事件

POST

/v2/cloud/server/events

设备端上报事件到云端，支持携带图片、视频等信息。

功能特点

支持统一的图片 URI 格式 (tgoss://)

自动解析 OSS ID 和图片路径

支持自定义扩展数据

支持视频标识

自动推送通知

典型场景

运动检测事件

人形检测事件

门铃按压事件

异常告警事件

请求参数

Header 参数

Body 参数application/json

示例

运动检测事件人形检测事件门铃事件

{
    "device_id": "abc-123-def-456",
    "time": 1234567890,
    "image_uri": "tgoss://123/events/2024/01/motion.jpg",
    "tag": "motion",
    "can_play": true,
    "data": {
        "confidence": "0.95",
        "region": "front_door"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

运动检测事件人形检测事件门铃事件

curl --location --request POST '/v2/cloud/server/events' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'X-Tg-Algorithm: TGV1-HMAC-SHA256' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-Content-Sha256;' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "device_id": "abc-123-def-456",
    "time": 1234567890,
    "image_uri": "tgoss://123/events/2024/01/motion.jpg",
    "tag": "motion",
    "can_play": true,
    "data": {
        "confidence": "0.95",
        "region": "front_door"
    }
}'

返回响应

🟢200成功

application/json

事件发布成功

Body

示例

成功示例设备 ID 格式错误图片 URI 格式错误成功示例

{
    "code": 200,
    "msg": "success",
    "data": null
}

🟠400请求有误

🟠401没有权限

修改于 2026-01-15 04:25:02