单次推送

前提條件¶

要與單一推送 API 同步，請確保發出授權令牌（API KEY）。如果您已經擁有該密鑰，請請求額外的權限。請參考 Hive 伺服器 API > 通知 > 推送 v4 > 認證 以查看如何請求和發出授權令牌。

網址¶

基本資料和請求變數¶

識別符結構¶

識別碼範例¶

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

訊息結構¶

iostitleTitleStringOfacebooktitleTitle（在1~30個字母內）StringO

選項資訊¶

輸出結果¶

回應狀態碼¶

範例代碼¶

• 呼叫 ("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":""},"facebook":{"title":"測試", "body":"測試消息正文", "media": "https://image.newdaily.co.kr/site/data/img/2022/05/13/2022051300019_0.jpg"}},"option":{"badge":"1","overwrite":false,"collapseKey":"","engagement":"","groupKey": "", "android":{"icon":"","sound":"", "priority": "normal"},"ios":{"sound":""}}}}'
  > -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":""},"facebook":{"title":"測試", "body":"測試消息正文", "media": "https://image.newdaily.co.kr/site/data/img/2022/05/13/2022051300019_0.jpg"}},"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"
                  },
                  "facebook": {
                      "title": "test_Korean_title",
                      "body": "test_Korean_message",
                      "media": "https://image.newdaily.co.kr/site/data/img/2022/05/13/2022051300019_0.jpg"
                  }
              },
              "en": {
                  "android": {
                      "title": "test_English title",
                      "message": "test_English message"
                  },
                  "ios": {
                      "title": "test_English title",
                      "message": "test_English message"
                  },
                  "facebook": {
                      "title": "test_English title",
                      "body": "test_English message",
                      "media": "https://image.newdaily.co.kr/site/data/img/2022/05/13/2022051300019_0.jpg"
                  }
              }
          },
          "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