上报事件

POST

http://openapi-cn01.tange365.com/v2/cloud/server/events

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

功能特点

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

自动解析 OSS ID 和图片路径

支持自定义扩展数据

支持视频标识

自动推送通知

典型场景

运动检测事件

人形检测事件

门铃按压事件

异常告警事件

请求参数

Header 参数

Body 参数application/json

示例

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

{
    "device_id": "1702D8OBYWWQ",
    "time": 1762358400,
    "image_uri": "tgoss://123/1702D8OBYWWQ/2026/05/body.jpg",
    "tag": "bd",
    "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 'http://openapi-cn01.tange365.com/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 'X-Tg-Api-Version: 2.1' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "1702D8OBYWWQ",
    "time": 1762358400,
    "image_uri": "tgoss://123/1702D8OBYWWQ/2026/05/body.jpg",
    "tag": "bd",
    "can_play": true,
    "data": {
        "confidence": "0.95",
        "region": "front_door"
    }
}'

返回响应

🟢200成功

application/json

事件发布成功

Bodyapplication/json

示例

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

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

🟠400请求有误

🟠401没有权限

修改于 2026-05-08 06:06:23