এরর
প্রতিটি প্রত্যাখ্যানের একটিই গঠন। 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 তৈরি করবেন না।