แพ็กเกจและคีย์
Standard: คีย์อ่านอย่างเดียว 1 คีย์ Pro: สูงสุด 5 คีย์ที่เขียนได้ด้วย (ไวท์ลิสต์ รายการคิวพิเศษ เตะออก ข้อความ การแบน) พร้อม webhook ที่มีลายเซ็น Community: คีย์ไม่จำกัด การค้นหาผู้เล่นและลีดเดอร์บอร์ด และขีดจำกัดที่สูงขึ้น
API token ใช้การกระทำเกี่ยวกับเงิน ธนาคาร ATM โรงรถ การล้างฐาน สิทธิ์แอดมิน พรีเมียม ชื่อเสียง หรือม็อดไม่ได้: สิทธิ์แอดมินของ TheModBase พรีเมียมของ TB (ให้หรือถอน) ชื่อเสียงของ TB และการกระทำของม็อด DayzHUB ใช้ได้จากแดชบอร์ดเท่านั้น การให้และสปอว์นไอเท็มยังใช้ผ่าน API ได้ตามเดิม
การให้และสร้างไอเทมผ่าน API ต้องใช้สิทธิ์โทเค็น "Can give and spawn items" (ช่องทำเครื่องหมายเมื่อสร้างโทเค็นแบบเขียน) โทเค็นใหม่จะปิดไว้ ส่วนโทเค็นที่สร้างก่อนหน้ายังคงมีสิทธิ์นี้
- เปิด API แล้วเลือก New token
- ตั้งชื่อ เลือกแบบอ่านหรือเขียน และหากต้องการ จำกัดให้ใช้กับบางเซิร์ฟเวอร์หรือกำหนดวันสิ้นสุด
- คัดลอกโทเค็น: จะแสดงเพียงครั้งเดียว
การเรียกใช้และขีดจำกัด
JSON ผ่าน HTTPS ที่ https://dayzhub.cloud/api/v1/console พร้อม Authorization: Bearer และโทเค็นของคุณ แต่ละคีย์มีขีดจำกัดอัตราการเรียกต่อนาทีและต่อวันของตัวเอง (Standard 30 และ 3000, Pro 120 และ 30000, Community 300 และ 150000) ไม่มี IP ของผู้เล่นหรือ BattlEye GUID อยู่ในข้อมูลเด็ดขาด
หน้า API แสดง base URL ที่แน่นอนของคุณ และคำอธิบาย OpenAPI ที่เครื่องอ่านได้เปิดเป็นสาธารณะที่ /api/v1/console/openapi.json
Webhook ที่มีลายเซ็น (Pro)
endpoint ของคุณเองจะได้รับการเข้าเกม การออกเกม การฆ่า การแบน สถานะเซิร์ฟเวอร์ รายงาน และการแจ้งเตือน เป็น JSON ที่มีลายเซ็น พร้อมการลองส่งซ้ำและบันทึกการส่ง เพิ่ม endpoint ในหน้า API แล้วคัดลอก secret (whsec_...)
ตรวจสอบลายเซ็น
- อ่าน header X-DHC-Timestamp และ X-DHC-Signature: ลายเซ็นมีลักษณะเป็น t=1760000000,v1=abc
- คำนวณ HMAC-SHA256 ของ timestamp ตามด้วยจุด และ body ดิบของคำขอแบบตรงตัว ด้วย secret ของ endpoint เป็น hex ตัวพิมพ์เล็ก
- เปรียบเทียบกับค่า v1 แต่ละค่าด้วยการเปรียบเทียบแบบ constant-time
- ปฏิเสธการส่งเมื่อ timestamp ต่างจากนาฬิกาของคุณมากกว่า 5 นาที และไม่สนใจ event id ที่คุณจัดการไปแล้ว
ควรรู้: ใช้ไบต์ดิบของ body ก่อนแยกวิเคราะห์ JSON ใดๆ ตัวอย่างสำหรับ Node, Python, curl และ PowerShell อยู่ในเอกสารอ้างอิง API