ข้อผิดพลาด

เมื่อคำขอ API ล้มเหลว badges.ninja จะส่งคืนการตอบกลับข้อผิดพลาด JSON พร้อมรหัสสถานะ HTTP ที่เหมาะสม

รูปแบบข้อผิดพลาด

ข้อผิดพลาดทั้งหมดเป็นไปตามโครงสร้างนี้:

{
  "error": "description of what went wrong"
}

รหัสสถานะ

รหัส	ความหมาย	เกิดเมื่อใด
400	Bad Request	พารามิเตอร์ขาดหายหรือไม่ถูกต้อง
402	Payment Required	ถึงโควตารางวัลรายเดือนหรือคุณสมบัติต้องการแพ็กเกจที่สูงกว่า
403	Forbidden	ถึงขีดจำกัดแพ็กเกจ (เช่น ขีดจำกัดผู้ออกหรือเหรียญตรา)
404	Not Found	ทรัพยากรที่ขอไม่มีอยู่
429	Too Many Requests	เกินขีดจำกัดอัตรา
500	Internal Server Error	เกิดข้อผิดพลาดที่ไม่คาดคิดบนเซิร์ฟเวอร์

ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข

ขาดพารามิเตอร์ที่จำเป็น

{ "error": "missing required parameters: name, url, email" }

วิธีแก้ไข: ระบุพารามิเตอร์ที่จำเป็นทั้งหมดในเนื้อหาคำขอของคุณ ดูเอกสารจุดสิ้นสุดสำหรับรายการเต็ม

อีเมลไม่ถูกต้อง

{ "error": "invalid email" }

วิธีแก้ไข: ระบุที่อยู่อีเมลที่ถูกต้องในรูปแบบ user@domain.com

URL ไม่ถูกต้อง

{ "error": "invalid URL" }

วิธีแก้ไข: ระบุ URL เต็มรวมโปรโตคอล เช่น https://example.com

ชื่อสั้นเกินไป

{ "error": "name must be at least 3 characters" }

วิธีแก้ไข: ใช้ชื่อที่ยาวขึ้น ชื่อผู้ออกต้องมีอย่างน้อย 3 อักขระ ชื่อผู้รับต้องมีอย่างน้อย 5 อักขระ

ผู้ออกยังไม่ได้รับการยืนยัน

{ "error": "issuer must be verified before creating badges" }

วิธีแก้ไข: ยืนยันผู้ออกก่อน ตรวจสอบอีเมลผู้ออกสำหรับลิงก์ยืนยัน หรือใช้จุดสิ้นสุด ยืนยันผู้ออก

ถึงโควตารางวัลรายเดือน

{ "error": "monthly award quota reached" }

วิธีแก้ไข: คุณใช้รางวัลทั้งหมดที่รวมอยู่ในแพ็กเกจของคุณสำหรับรอบการเรียกเก็บเงินนี้แล้ว (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo) รอการรีเซ็ตครั้งถัดไปหรืออัปเกรดแพ็กเกจของคุณ ดู แพ็กเกจ & การเรียกเก็บเงิน

ถึงขีดจำกัดแพ็กเกจ

{ "error": "issuer limit reached for your plan" }

วิธีแก้ไข: คุณได้ถึงขีดจำกัดของแพ็กเกจสำหรับผู้ออก เหรียญตรา หรือคีย์ API ลบทรัพยากรที่ไม่ได้ใช้หรืออัปเกรดแพ็กเกจของคุณ

บล็อกเชนต้องการ Pro

{ "error": "blockchain verification requires the Pro plan" }

วิธีแก้ไข: พารามิเตอร์ blockchain มีอยู่เฉพาะในแพ็กเกจ Pro อัปเกรดเพื่อเปิดใช้การตรวจสอบบนเชน

บล็อกเชนที่ไม่รองรับ

{ "error": "unsupported blockchain, only 'matchain' is supported" }

วิธีแก้ไข: ปัจจุบันรองรับเฉพาะ matchain เป็นพารามิเตอร์บล็อกเชน

ทรัพยากรมีการพึ่งพา

{ "error": "issuer has badges and cannot be deleted" }

วิธีแก้ไข: ลบเหรียญตราทั้งหมดภายใต้ผู้ออกก่อนลบผู้ออก ในทำนองเดียวกัน ลบรางวัลทั้งหมดภายใต้เหรียญตราก่อนลบเหรียญตรา

ไม่ได้รับอนุญาต

{ "error": "not authorized" }

วิธีแก้ไข: คุณสามารถปรับเปลี่ยนเฉพาะทรัพยากรที่คุณเป็นเจ้าของเท่านั้น ตรวจสอบให้แน่ใจว่าคุณใช้คีย์ API ที่ถูกต้อง

HTML ในข้อความแชร์

{ "error": "HTML tags are not allowed" }

วิธีแก้ไข: ข้อความแชร์ต้องเป็นข้อความธรรมดา นำแท็ก HTML ออกจากพารามิเตอร์ text