上报手机推送ID

POST

https://openapi-cn01.tange365.com/v2/push/id

/v2/push/id

探鸽平台向APP推送设备的告警消息的字段定义：
"message_type": 消息类型:event/notice(string),
"tag": 事件标识:body/motion...(string),
"tag_name": 事件名称:人形/声音...(string),
"device_id": 旧版设备ID(int),
"uuid": 新版设备ID(string),
"start_time": 事件发生时间戳(int),
"start_ts": 事件发生时间戳(string),
"user_id": 设备所属用户ID(string),
"nickname": 设备名称(string),
"is_pay": 是否有录像可播放(int),
"des_key": 录像解密密码(string),
"image_path": 事件图片URL(string),
"ossid": 录像存储服务的ID(string),
"channel_id": 推送通道(string)
"tag_msg": 消息内容(string),
"tag_icon": 消息图标(string),
"is_ai_tag": 标识是否AI事件(int),
"requestid": AI识别请求ID(string),
"subclass": AI事件识别子类(string),
"similarity_degree": AI识别鸟类概率(string),

请求参数

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

X-Tg-Platform

string

必需

请求来源：android/ios/pc/web

默认值:

X-Tg-Sdk-Version

string

必需

API SDK版本号：1024

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

X-Tg-App-Store

string

手机APP应用商店

可选

默认值:

X-Tg-App-Pkgname

string

手机APP包名

必需

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-App-Version

string

APP版本号

可选

默认值:

Body 参数application/json

string

推送ID

必需

APP调用厂商SDK获取到的推送ID

channel

string

推送渠道

必需

手机厂商标识示例：huawei、aliyun、xiaomi等

sound

array [object {2}]

支持的自定义铃声列表

可选

仅支持iOS、华为、谷歌，上报完整文件路径，包含文件名、扩展名

channel

string

通道标识，国内厂商的推送通道

必需

ringtone

string

铃声文件名

必需

示例

{
  "id": "IQAAAACy0ZH4AACcCiBKU9qTgh2i4W-1Iqrg4-W0tL-XoDYizszZSLWqg32If7eD0YfNFzD1_Xnh2ZMBqhxErIw69Atj904flIwB_iJZHyyi0egSVg",
  "channel": "huawei",
  "sound": [
    {
      "channel": "pre54",
      "ringtone": "xm3413.mp3"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi-cn01.tange365.com/v2/push/id' \
--header 'X-Tg-App-Id;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Pkgname;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-App-Version: {{app_version}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "IQAAAACy0ZH4AACcCiBKU9qTgh2i4W-1Iqrg4-W0tL-XoDYizszZSLWqg32If7eD0YfNFzD1_Xnh2ZMBqhxErIw69Atj904flIwB_iJZHyyi0egSVg",
    "channel": "huawei",
    "sound": [
        {"channel":"pre54","ringtone":"xm3413.mp3"}
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

200表示成功

示例

{
  "code": 0
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-03-11 09:06:08

APP向设备发送消息

获取webRTC服务器的SDP