ข้ามไปที่เนื้อหา

ตรวจสอบข้อมูลผู้ใช้ที่ถูกบล็อก

API ตรวจสอบผู้ใช้ที่ถูกบล็อกในเกม จะแจ้งให้คุณทราบเกี่ยวกับ ผู้ใช้ที่ถูกระงับ เมื่อพยายามเข้าสู่ระบบโดยใช้การเข้าสู่ระบบผ่านเว็บจากชุมชน, หน้าเว็บเกม, เป็นต้น

พื้นฐาน

  คำอธิบาย
URL ที่ร้องขอ
  • เชิงพาณิชย์: https://weblogin.withhive.com/block_info
  • Sandbox: https://sandbox-weblogin.withhive.com/block_info
วิธีการ POST
HTTP Header Content-type: application/json
รูปแบบการตอบกลับ JSON

คำขอ

ชื่อ ประเภท จำเป็น คำอธิบาย
appid String O AppID
player_id Integer O PlayerID
language String X

นี่คือค่าภาษา หากปล่อยว่างจะถูกตั้งค่าเป็นภาษาอังกฤษโดยอัตโนมัติ

  • ko (เกาหลี)
  • en (อังกฤษ)
  • ja (ญี่ปุ่น)
  • zh-hans (จีนแบบย่อ)
  • zh-hant (จีนแบบดั้งเดิม)
  • de (เยอรมัน)
  • fr (ฝรั่งเศส)
  • ru (รัสเซีย)
  • es (สเปน)
  • pt (โปรตุเกส)
  • id (อินโดนีเซีย)
  • th (ไทย)
  • vi (เวียดนาม)
  • it (อิตาลี)
  • tr (ตุรกี)
  • ar (อาหรับ)

Response

ชื่อ ประเภท คำอธิบาย หมายเหตุ
รหัส จำนวนเต็ม รหัสผลลัพธ์
  • 100: สำเร็จ
  • 2002: เนื้อหาของคำขอไม่มีอยู่.
  • 2005: appid หรือ player_id ไม่มีอยู่.
  • 2011: appid ไม่ถูกต้อง.
  • 2016: เกมไม่ถูกต้อง.
  • 2019: บริษัทไม่ถูกต้อง.

* ไม่ถูกต้อง: ไม่มีค่า หรือมีค่าเป็น null หากคุณได้รับ 2016 หรือ 2019 ให้ไปที่ Hive Console AppCenter และตรวจสอบการกำหนดค่าของเกมหรือบริษัท.

ข้อมูล วัตถุ ข้อมูลผลลัพธ์
data.is_blocked บูลีน ผู้ใช้ถูกบล็อกในเกมหรือไม่.
  • true: ผู้ใช้ถูกบล็อก
  • false: ผู้ใช้ปกติ
data.status สตริง สถานะการบล็อก
  • N: ปกติ
  • P: ถูกบล็อกถาวร
  • B: ถูกบล็อกในช่วงเวลาที่กำหนด
data.start_date สตริง วันที่และเวลาที่เริ่มบล็อก
data.end_data สตริง วันที่และเวลาที่สิ้นสุดการบล็อก
data.remaining_date สตริง จำนวนวันที่เหลือจนกว่าการบล็อกจะถูกปล่อย จะแสดงตามค่าภาษา `language` ที่ให้ไว้ (ค่าเริ่มต้น: ภาษาอังกฤษ)
data.reason สตริง เหตุผลในการบล็อก จะแสดงตามค่าภาษา `language` ที่ให้ไว้ (ค่าเริ่มต้น: ภาษาอังกฤษ)

ตัวอย่างคำขอ

    curl -X POST https://weblogin.withhive.com/block_info
    -H 'Content-Type: application/json'
    -d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "player_id": 20000020208, "language": "ko"}'

ตัวอย่างการตอบกลับ

ความสำเร็จ (ผู้ใช้ปกติ)

    {
            "code": 100,
            "data": {
                    "is_blocked": false,
                    "status": "N",
                    "start_date": null,
                    "end_date": null,
                    "remaining_date": null,
                    "reason": null
            }
    }

ความสำเร็จ (ผู้ใช้ถูกบล็อกเป็นระยะเวลาที่กำหนด)

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "B",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "2023-10-10 14:42:17",
                    "remaining_date": "90 day(s)",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

ความสำเร็จ (ผู้ใช้ถูกบล็อกถาวร)

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "P",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "9999-12-31 00:00:00",
                    "remaining_date": "Permanent",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

ความล้มเหลว

    {
            "code": 2002,
            "data": {}
    }