单次推送

先決條件¶

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

按環境訪問 URL¶

基本信息和请求参数¶

通知警報工作流程¶

通知警報僅發送給已同意接收的遊戲應用程序用戶。如果通知警報在 21:00~08:00 之間發送，則需要額外的同意以接收夜間警報。

通知警報工作流程的詳細信息如下：

• 如果用戶不同意接收通知警報，所有設置為通知的消息將不會發送。
• 只有同意接收通知警報的用戶才能同意夜間警報。

標識結構¶

標識範例¶

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

訊息結構¶

選項資訊¶

ActionPayload¶

ActionPayload 是在使用推送操作按钮时传递的数据格式，这是单一推送 API 的一个附加功能。

推送操作按钮是SDK中可用的通知功能，在长按推送通知时显示为系统按钮。

有關推送操作按鈕的更多詳細信息，請參見以下指南。

• SDK 開發指南 > 推送操作按鈕
• Apple > 設定推播通知用戶操作的指南
• Android > FCM 操作按鈕指南

ActionPayload 数据结构¶

在请求单个推送 API 时，ActionPayload 中包含的数据如下。

行動¶

操作是 ActionPayload 中每个系统按钮的数据。Action 中包含的参数如下。

輸出 > 回應參數結構¶

回應狀態碼¶

範例代碼¶

• 請求 ("enableLocale":false)

    POST /push/send HTTP/1.1
      Host: sandbox-notification.qpyou.cn
      Content-Type: application/json
      Authorization: Bearer {API KEY}
      Content-Length: [自動計算]
  
  
    {
        "notice": false,
        "identifiers": [
            {
                "playerId": 200001358,
                "did": 300010915
            }
        ],
        "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": false,
        "payload": {
            "single": {
                "android": {
                    "title": "android title",
                    "message": "android message",
                    "messageExpanded": "",
                    "imageUrl": "",
                    "ticker": "",
                    "summaryText": ""
                },
                "ios": {
                    "title": "ios title",
                    "message": "ios message",
                    "mediaUrl": ""
                }
            },
            "option": {
                "badge": "1",
                "overwrite": false,
                "collapseKey": "",
                "engagement": "",
                "groupKey": "",
                "android": {
                    "icon": "",
                    "sound": "",
                    "priority": "normal"
                },
                "ios": {
                    "sound": ""
                }
            }
        },
        "actionInfo": {
            "android": {
                "actions": [
                    {
                        "titles": {
                            "default": "OK"
                        },
                        "actionType": "CURL",
                        "action": "https://examplecurl.com"
                    },
                    {
                        "titles": {
                            "default": "Cancel"
                        },
                        "actionType": "CLOSE",
                        "action": ""
                    }
                ]
            },
            "ios": {
                "category": "CONFIRM_CATEGORY",
                "actions": [
                    {
                        "actionId": "CONFIRM_ID",
                        "actionType": "CURL",
                        "action": "https://examplecurl.com"
                    },
                    {
                        "actionId": "CLOSE_ID",
                        "actionType": "CLOSE",
                        "action": ""
                    }
                ]
            }
        }
    }
  

• 请求 ("enableLocale":true)

  POST /push/send HTTP/1.1
  Host: sandbox-notification.qpyou.cn
  Content-Type: application/json
  Authorization: Bearer {API KEY}
  Content-Length: [auto calculated]
  
  {
      "notice": false,
      "identifiers": [
          {
              "playerId": 200001358,
              "did": 300010915
          }
      ],
      "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": "測試_韓語標題",
                      "message": "測試_韓語訊息"
                  },
                  "ios": {
                      "title": "測試_韓語標題",
                      "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"
              }
          }
      },
      "actionInfo": {
          "android": {
              "actions": [
                  {
                      "titles": {
                          "default": "確定",
                          "en": "OK",
                          "ko": "확인"
                      },
                      "actionType": "CURL",
                      "action": "https://examplecurl.com"
                  },
                  {
                      "titles": {
                          "default": "取消",
                          "en": "Cancel",
                          "ko": "취소"
                      },
                      "actionType": "CLOSE",
                      "action": ""
                  }
              ]
          },
          "ios": {
              "category": "CONFIRM_CATEGORY",
              "actions": [
                  {
                      "actionId": "CONFIRM_ID",
                      "actionType": "CURL",
                      "action": "https://examplecurl.com"
                  },
                  {
                      "actionId": "CLOSE_ID",
                      "actionType": "CLOSE",
                      "action": ""
                  }
              ]
          }
      }
  }
  

• 回應

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