批量向用户APP推送通知

POST

/v2/push/users

如果需要用推送渠道的消息通道，通过args['channel_id']值传即可。

请求参数

Header 参数

Body 参数application/json

示例

{
    "user_id": [
        1,
        2,
        3
    ],
    "title": "消息标题",
    "body": "消息内容",
    "args": {
        "k1": "v1",
        "k2": "v2"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/push/users' \
--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 '{
    "user_id": [
        1,
        2,
        3
    ],
    "title": "消息标题",
    "body": "消息内容",
    "args": {
        "k1": "v1",
        "k2": "v2"
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "success",
    "ok": 1,
    "requestid": "4c091e7c-6a8d-43cc-87bb-8f0388420c6c",
    "status": "success",
    "data": {
        "4155264": {
            "ok": true,
            "msg": ""
        }
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2025-12-16 13:43:44

向用户APP推送通知

查询用户APP推送信息