单推

先决条件¶

要与单推送 API 同步，请确保发出授权令牌（API 密钥）。如果您已经拥有密钥，请请求额外的权限。请参阅 Hive 服务器 API > 通知 > 推送 v4 > 身份验证 以检查如何请求和发出授权令牌。

标识符结构¶

标识符示例¶

[
  {
    "playerId":51234,
    "vid":11232,
    "did":1234
  }
]

消息结构¶

选项信息¶

输出结果¶

响应状态代码¶

示例代码¶

• 调用 ("enableLocale":false)

  curl -L -v
  > -d '{"notice":false,"identifiers":[{"vid":19239,"did":300010915}],"game":{"gameid":"com.com2us.hivesdk","appids":["com.com2us.hivesdk.normal.freefull.google.global.android.common"]},"enableLocale":false,"payload":{"single":{"android":{"title":"测试","message":"测试","messageExpanded":"","imageUrl":"","ticker":"","summaryText":""},"ios":{"title":"","message":"","mediaUrl":""}},"option":{"badge":"1","overwrite":false,"collapseKey":"","engagement":"","groupKey": "", "android":{"icon":"","sound":"", "priority": "normal"},"ios":{"sound":""}}}}'
  > -H "Content-Type: application/json"
  > -H "Authorization: Bearer {API KEY}"
  > https://sandbox-notification.qpyou.cn/push/send
  

• 调用 ("enableLocale":true)

  {
      "notice": false,
      "identifiers": [
          {
              "playerId": 30000028045
  }
  ],
      "game": {
          "gameid": "com.com2us.hivesdk",
          "appids": [
  "com.com2us.hivesdk.normal.freefull.google.global.android.common",
  "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal"
  ]
      },
      "enableLocale": true,
      "payload": {
          "defaultLanguage": "en",
          "locale": {
              "ko": {
                  "android": {
                      "title": "test_Korean_title",
                      "message": "test_Korean_message"
                  },
                  "ios": {
                      "title": "test_Korean_title",
                      "message": "test_Korean_message"
                  },
              },
              "en": {
                  "android": {
                      "title": "test_English title",
                      "message": "test_English message"
                  },
                  "ios": {
                      "title": "test_English title",
                      "message": "test_English message"
                  },
              }
          },
          "option": {
              "badge": 1,
              "overwrite": true,
              "collapseKey": "99",
              "groupKey": "",
              "android": {
                  "icon": "GoogleIcon",
                  "sound": "GoogleSound",
                  "priority": "normal"
              },
              "ios": {
                  "sound": "AppleSound"
              }
          }
      }
  }
  

请求

> POST /push/send HTTP/1.1
> User-Agent: curl/7.29.0
> Host: sandbox-notification.qpyou.cn
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE1NDE1NzMyOTcsImp0aSI6ImFkbWluaXN0cmF0b3IifQ.23nG9RnbuOwnMbRSebBi2i-Qt_fOfqU_vUKUZ2JJlWU
> Content-Length: 502

• 响应

< HTTP/1.1 200 OK
< content-length: 0
< Content-Type: application/json
< UUID: 3bc6b414-e2df-40d6-8006-9d2308a6edf9