ข้อผิดพลาด
การปฏิเสธทุกครั้งมีรูปแบบเดียวกัน ให้ดำเนินการตาม code ซึ่งไม่มีวันเปลี่ยน ส่วน message มีไว้สำหรับคนอ่านและอาจเปลี่ยนได้
รูปแบบของข้อผิดพลาด
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}ระบุ request_id เมื่อติดต่อฝ่ายสนับสนุน ทุกการตอบกลับมีค่านี้ในเฮดเดอร์ Request-Id ด้วย
โค้ดทั้งหมด
เป็นคำขอที่ API ไม่เข้าใจ ข้อความจะบอกเหตุผล แก้ไขก่อนส่งอีกครั้ง
POST /orders ต้องมีเฮดเดอร์ Idempotency-Key ที่ถูกต้อง เป็นอักขระ ASCII ไม่เกิน 200 ตัวโดยไม่มีช่องว่างมีบรรทัดในรายชื่อที่ไม่ใช่สิ่งที่ตัวตรวจสอบรับ ข้อความจะแสดงตัวอย่าง
ตัวตรวจสอบนี้ต้องการรายการต่อไฟล์มากกว่านี้
รายชื่อยาวเกินไป สูงสุด 100,000 รายการในคำขอ หรือ 10,000,000 รายการในการอัปโหลด
ไฟล์มีขนาดเกิน 200 MB
country ที่คุณส่งไม่ตรงกับเบอร์ในรายชื่อไฟล์ต้องมีเบอร์จากประเทศเดียว แยกเป็นหนึ่งไฟล์ต่อหนึ่งประเทศ
upload_id นั้นไม่ใช่ของคุณ ไฟล์ยังอัปโหลดไม่เสร็จ หรือไฟล์ไม่มีอยู่แล้ว (ไฟล์ที่อัปโหลดจะรอคำสั่งซื้อ 24 ชั่วโมง) หากคุณสั่งซื้อจากการอัปโหลดนี้ไปแล้วและการตอบกลับสูญหาย ให้ส่งคำขอนั้นซ้ำด้วยคีย์ idempotency เดิม มิฉะนั้นให้อัปโหลดไฟล์อีกครั้งและสั่งซื้อด้วยคีย์ idempotency ใหม่ เพราะไม่มีการสร้างคำสั่งซื้อภายใต้คีย์เก่าไฟล์เปลี่ยนไปหลังจากคำนวณราคา ไม่มีการสร้างคำสั่งซื้อ อัปโหลดอีกครั้งและสั่งซื้อด้วยคีย์ idempotency ใหม่
ราคาเก่าเกินกว่าจะใช้ได้ ส่งคำขอซ้ำด้วย
Idempotency-Key เดิมinvalid_key
401คีย์ API หายไป ผิด หรือไม่ใช่คีย์ของเรา
revoked_key
401คีย์ API นี้ถูกเพิกถอนแล้ว ใช้คีย์ API อื่น
expired_key
401คีย์ API นี้หมดอายุแล้ว สร้างคีย์ API ใหม่
ยอดคงเหลือของคุณไม่พอสำหรับคำสั่งซื้อนี้ เติมเงิน แล้วส่งซ้ำด้วยคีย์ idempotency เดิม
key_blocked
403คีย์ API นี้ถูกบล็อก ติดต่อฝ่ายสนับสนุน
คีย์ API นี้จำกัดให้ใช้กับที่อยู่ IP อื่น
บัญชีนี้ใช้ API ไม่ได้ ติดต่อฝ่ายสนับสนุน
การเข้าถึง API ของบัญชีนี้ถูกปิดอยู่ เว็บไซต์ยังใช้งานได้ตามปกติ ติดต่อฝ่ายสนับสนุน
คีย์ API นี้เป็นแบบอ่านอย่างเดียว และการเรียกนี้ต้องใช้คีย์ API ที่สั่งซื้อได้
ตัวตรวจสอบนี้ไม่เปิดให้บัญชีของคุณใช้ในขณะนี้ ดู
GET /checkersที่อยู่ของคุณถูกบล็อก ติดต่อฝ่ายสนับสนุน
not_found
404ไม่มีคำสั่งซื้อหรือเอนด์พอยต์ดังกล่าวในบัญชีนี้
คีย์ idempotency นี้ถูกใช้กับคำขออื่นแล้ว ใช้คีย์ idempotency ใหม่สำหรับคำสั่งซื้อใหม่
ราคาไม่ตรงกับที่คุณคาดไว้ หรือเปลี่ยนไปตั้งแต่ส่งคีย์ idempotency นี้ครั้งแรก ไม่มีการสร้างคำสั่งซื้อ ใช้คีย์ idempotency ใหม่เพื่อสั่งซื้อในราคาใหม่
คำขอมีขนาดเกิน 4 MB ใช้
POST /uploads สำหรับรายชื่อขนาดใหญ่คุณมีไฟล์อัปโหลดที่รออยู่มากเกินไป (20 ไฟล์หรือ 100 MB) หรืออัปโหลดวันนี้มากเกินไป (500 ครั้ง) สั่งซื้อจากไฟล์ใดไฟล์หนึ่ง หรือลองอีกครั้งภายหลัง ไฟล์ที่อัปโหลดจะถูกลบหลัง 24 ชั่วโมง
rate_limited
429คุณเกินขีดจำกัดอัตรา รอตามจำนวนวินาทีใน
Retry-After หากเป็นคำสั่งซื้อ ให้ส่งซ้ำด้วยคีย์ idempotency เดิม ดูขีดจำกัดอัตราคุณมีคำสั่งซื้อที่ยังไม่เสร็จมากเกินไป รอตามจำนวนวินาทีใน
Retry-After แล้วส่งคำสั่งซื้อซ้ำด้วยคีย์ idempotency เดิมเกิดปัญหาบางอย่างทางฝั่งเรา สำหรับ
POST /orders คำสั่งซื้ออาจสำเร็จแล้ว ดังนั้นให้ส่งคำขอซ้ำด้วย Idempotency-Key เดิม ซึ่งจะไม่เรียกเก็บเงินซ้ำเด็ดขาด สำหรับการเรียกอื่น ให้ลองอีกครั้ง หรือติดต่อฝ่ายสนับสนุนพร้อม request_idapi_disabled
503API ปิดอยู่ในขณะนี้ ลองอีกครั้งภายหลัง หากเป็นคำสั่งซื้อ ให้ส่งซ้ำด้วยคีย์ idempotency เดิม
API ไม่สามารถตอบกลับได้ในขณะนี้ รอหนึ่งนาทีแล้วส่งคำขอซ้ำด้วยคีย์ idempotency เดิม
เราไม่สามารถยืนยันคำสั่งซื้อได้ ส่งคำขอซ้ำด้วย
Idempotency-Key เดิมเพื่อดูสถานะจริง ซึ่งจะไม่เรียกเก็บเงินซ้ำเด็ดขาด หากยังตอบกลับเช่นนี้นานเกินกว่าสองสามนาที ให้หยุดและติดต่อฝ่ายสนับสนุนพร้อม request_id อย่าสร้างคีย์ idempotency ใหม่