خرابیاں
ہر انکار کی ایک ہی شکل ہوتی ہے۔ 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 سے آرڈر دیں۔
یہ قیمت استعمال کرنے کے لیے بہت پرانی ہے۔ ریکویسٹ وہی
Idempotency-Key لگا کر دہرائیں۔invalid_key
401API کلید موجود نہیں، غلط ہے، یا ہماری نہیں ہے۔
revoked_key
401یہ API کلید منسوخ کر دی گئی ہے۔ دوسری استعمال کریں۔
expired_key
401اس API کلید کی تاریخ گزر چکی ہے۔ نئی API کلید بنائیں۔
اس آرڈر کے لیے آپ کا بیلنس بہت کم ہے۔ ٹاپ اپ کریں، پھر اسے وہی Idempotency-Key لگا کر دہرائیں۔
key_blocked
403یہ API کلید بلاک کر دی گئی ہے۔ سپورٹ سے رابطہ کریں۔
یہ API کلید دوسرے IP پتوں تک محدود ہے۔
یہ اکاؤنٹ API استعمال نہیں کر سکتا۔ سپورٹ سے رابطہ کریں۔
اس اکاؤنٹ کے لیے API رسائی بند کر دی گئی ہے۔ ویب سائٹ بدستور کام کرتی ہے۔ سپورٹ سے رابطہ کریں۔
یہ API کلید صرف پڑھنے والی ہے، اور اس کال کے لیے ایسی API کلید درکار ہے جو آرڈر دے سکے۔
یہ چیکر ابھی آپ کے اکاؤنٹ کے لیے کھلا نہیں ہے۔ دیکھیں
GET /checkers۔آپ کا IP پتا بلاک کر دیا گیا ہے۔ سپورٹ سے رابطہ کریں۔
not_found
404اس اکاؤنٹ پر ایسا کوئی آرڈر یا endpoint نہیں ہے۔
یہ 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 نہ بنائیں۔