การส่งแบบเดี่ยว

ข้อกำหนดเบื้องต้น¶

ในการซิงค์กับ Single Push API ให้แน่ใจว่าคุณได้ออกโทเค็นการอนุญาต (API KEY) หากคุณมีคีย์แล้ว ให้ขอสิทธิ์เพิ่มเติม ดูที่ Hive Server API > Notification > Push v4 > Authentication เพื่อตรวจสอบวิธีการขอและออกโทเค็นการอนุญาต

เข้าถึง 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: [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": 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