الأخطاء
لكل رفض شكل واحد. تصرّف بناءً على 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 صالحة: ما يصل إلى 200 حرف ASCII بلا مسافات.سطر في القائمة ليس مما تقبله أداة الفحص. تعرض الرسالة أمثلة.
تحتاج أداة الفحص هذه إلى إدخالات أكثر في كل ملف.
القائمة طويلة جدًا: حتى 100,000 إدخال في الطلب، أو 10,000,000 في ملف مرفوع.
حجم الملف يتجاوز 200 MB.
country الذي أرسلته لا يطابق الأرقام في القائمة.يجب أن يضم الملف أرقامًا من بلد واحد. قسّمه إلى ملف لكل بلد.
upload_id هذا ليس لك، أو لم يكتمل رفع ملفه، أو لم يعد ملفه موجودًا (ينتظر الملف المرفوع طلبية لمدة 24 ساعة). إذا كنت قد قدّمت طلبية من هذا الملف المرفوع وضاعت الاستجابة، فأعد ذلك الطلب بمفتاح Idempotency-Key الأصلي. وإلا فارفع الملف مجددًا وقدّم الطلبية بمفتاح Idempotency-Key جديد: لم تُقدَّم أي طلبية بالمفتاح القديم.تغيّر الملف بعد تسعيره. لم تُقدَّم أي طلبية. ارفعه مجددًا وقدّم الطلبية بمفتاح Idempotency-Key جديد.
السعر أقدم من أن يُستخدم. أعد الطلب بمفتاح
Idempotency-Key نفسه.invalid_key
401مفتاح API مفقود أو خاطئ أو ليس من مفاتيحنا.
revoked_key
401أُلغي مفتاح API هذا. استخدم مفتاح API آخر.
expired_key
401انتهت صلاحية مفتاح API هذا. أنشئ مفتاح API جديدًا.
رصيدك أقل من أن يغطي هذه الطلبية. اشحن رصيدك، ثم أعدها بمفتاح Idempotency-Key نفسه.
key_blocked
403حُظر مفتاح API هذا. تواصل مع الدعم.
مفتاح API هذا مقصور على عناوين IP أخرى.
لا يمكن لهذا الحساب استخدام API. تواصل مع الدعم.
تم إيقاف الوصول إلى API لهذا الحساب. الموقع لا يزال يعمل. تواصل مع الدعم.
مفتاح API هذا للقراءة فقط، ويحتاج هذا الاستدعاء إلى مفتاح API قادر على تقديم الطلبيات.
أداة الفحص هذه غير متاحة لحسابك حاليًا. راجع
GET /checkers.حُظر عنوان IP الخاص بك. تواصل مع الدعم.
not_found
404لا توجد طلبية أو نقطة نهاية كهذه في هذا الحساب.
استُخدم مفتاح Idempotency-Key هذا مع طلب مختلف. استخدم مفتاح Idempotency-Key جديدًا لكل طلبية جديدة.
السعر ليس ما توقعته، أو تغيّر منذ أول إرسال لمفتاح Idempotency-Key. لم تُقدَّم أي طلبية. استخدم مفتاح Idempotency-Key جديدًا لتقديم الطلبية بالسعر الجديد.
حجم الطلب يتجاوز 4 MB. استخدم
POST /uploads للقائمة الكبيرة.لديك ملفات مرفوعة كثيرة جدًا قيد الانتظار (20 ملفًا أو 100 MB)، أو أجريت عمليات رفع كثيرة جدًا اليوم (500). قدّم طلبية من أحدها، أو حاول لاحقًا: يُحذف الملف المرفوع بعد 24 ساعة.
rate_limited
429تجاوزت أحد حدود المعدل. انتظر عدد الثواني المذكور في
Retry-After. إذا كانت طلبية، فأعدها بمفتاح Idempotency-Key نفسه. راجع حدود المعدل.لديك طلبيات غير منتهية كثيرة جدًا. انتظر عدد الثواني المذكور في
Retry-After، ثم أعد الطلبية بمفتاح Idempotency-Key نفسه.حدث خطأ من جهتنا. في
POST /orders ربما تكون الطلبية قد وصلت، لذا أعد الطلب بمفتاح Idempotency-Key نفسه: لا يخصم ذلك مرتين أبدًا. في أي استدعاء آخر، حاول مجددًا، أو تواصل مع الدعم مع ذكر request_id.api_disabled
503API متوقفة حاليًا. حاول لاحقًا. إذا كانت طلبية، فأعدها بمفتاح Idempotency-Key نفسه.
لا تستطيع API الاستجابة الآن. انتظر دقيقة وأعد الطلب بمفتاح Idempotency-Key نفسه.
تعذّر علينا تأكيد الطلبية. أعد الطلب بمفتاح
Idempotency-Key نفسه لتعرف حالتها الحقيقية: لا يخصم ذلك مرتين أبدًا. إذا استمرت هذه الاستجابة أكثر من بضع دقائق، فتوقف وتواصل مع الدعم مع ذكر request_id. لا تنشئ مفتاح Idempotency-Key جديدًا.