ত্রুটি এবং পুনরায় চেষ্টা
ব্যবসায়িক ত্রুটিগুলো প্রতিক্রিয়া বডিতে শীর্ষ স্তরে code এবং message হিসেবে ফেরত দেয়। detail সাধারণত message-এর মতোই হয়, তবে এটি ভিন্ন, সংক্ষিপ্ত ব্যাখ্যা হতে পারে (নিচের মতো); ব্যবহারকারীদের জন্য message প্রদর্শন করুন। বার্তাগুলো চীনা ভাষায়:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}কয়েকটি ব্যবসায়িক ত্রুটি কেবল code ফেরত দেয়। যাচাইকরণ ব্যর্থতা detail-এ ক্ষেত্রের ত্রুটিগুলোর একটি তালিকা সহ 422 ফেরত দেয়:
{ "detail": [ { "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" } ]}HTTP স্ট্যাটাসের মাধ্যমে ত্রুটিগুলি প্রথমে হ্যান্ডেল করুন, তারপর code দ্বারা: অনেক ত্রুটি শুধুমাত্র জেনেরিক UNKNOWN_ERROR ফেরত দেয়, এবং কেবল কিছু ত্রুটিই একটি নির্দিষ্ট code বহন করে (যেমন নিচের 429টি ক্ষেত্রে)। ট্রাবলশুটিংয়ের জন্য X-Request-Id রেসপন্স হেডারটি রেকর্ড করুন।
HTTP স্ট্যাটাস
Section titled “HTTP স্ট্যাটাস”| স্ট্যাটাস | অর্থ | পরামর্শ |
|---|---|---|
400 | অবৈধ অনুরোধ, উদাহরণস্বরূপ নির্বাচিত সেটিংসটি উপলব্ধ নয়। | অনুরোধটি ঠিক করুন; পুনরায় চেষ্টা করবেন না |
401 | crendential অনুপস্থিত, অবৈধ, মেয়াদোত্তীর্ণ বা বাতিল করা হয়েছে | আর্থিক শংসাপত্র পরিবর্তন করুন |
402 | অবশিষ্ট ভারসাম্য (ঋণ বাদে) কাজের সীমা ছাড়িয়ে যায়নি অথবা তা ঋণাত্মক; একটি API কী থাকলে, কীটির অবশিষ্ট বাজেট খুব কম হতে পারে। | টপ আপ (অথবা কী-এর বাজেট বাড়ান), তারপর আবার জমা দিন |
403 | কীগুলির সীমা এই কার্যকারিতাটি অনুমতি দেয় না (উদাহরণস্বরূপ, অনুবাদ সেটিংস অনুমোদিত নয়), অ্যাকাউন্টটি নিষ্ক্রিয় করা আছে, অথবা এই কার্যকারিতাটি লগইন করা ব্রাউজারে করতে হবে (যেমন API কী পরিচালনা করা)। | কী সেটিংসগুলি পরীক্ষা করুন অথবা ওয়েবসাইটটি ব্যবহার করুন |
404 | সংস্থানটি বিদ্যমান নেই, মুছে ফেলা হয়েছে অথবা অন্য একটি অ্যাকাউন্টের অন্তর্গত (এই তিনটি দেখতে একই রকম) | আইডি পরীক্ষা করুন |
409 | ইডেম্পোটেন্সি কীটি অন্য কোনো অনুরোধে ব্যবহার করা হয়েছিল, অথবা সংস্থানের অবস্থা এই কার্যকলাপকে অনুমতি দেয় না। | আসল অপারেশনটি জিজ্ঞাসা করুন, তারপর সিদ্ধান্ত নিন |
410 | সংস্থান বা এন্ডপয়েন্টটি স্থায়ীভাবে অনুপলব্ধ, উদাহরণস্বরূপ একটি বন্ধ করা এন্ডপয়েন্ট বা একটি আইডেম্পোটেন্সি কী-এর পিছনে মুছে ফেলা জব। | পুনরায় চেষ্টা করবেন না |
413 | ফাইল বা অনুরোধের বডি সীমা অতিক্রম করেছে | একটি ছোট ফাইল ব্যবহার করুন |
415 | অসমর্থিত ফাইল বিন্যাস | অন্য একটি ফরম্যাট ব্যবহার করুন |
422 | যাচাইকরণ ব্যর্থ হয়েছে, অথবা ফাইলটি খালি বা প্রক্রিয়া করার মতো কিছু নেই। | ক্ষেত্রগুলি ঠিক করুন; স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করবেন না |
429 | হার, কিউ আকার বা বাজেট সীমিত | নীচে দেখুন |
5xx | অস্থায়ী পরিষেবা ত্রুটি | সর্বোচ্চ প্রয়াসের সংখ্যা সহ ঘাতাত্মক ব্যাকঅফ |
429 প্রক্রিয়াকরণ
Section titled “429 প্রক্রিয়াকরণ”code | অর্থ | কী করবেন |
|---|---|---|
RATE_LIMITED | অনেক বেশি অনুরোধ | Retry-After এর জন্য অপেক্ষা করুন, তারপর পুনরায় চেষ্টা করুন |
CONCURRENCY_LIMITED | অতিরিক্ত সংখ্যক ফাইল অনুবাদ কাজ লাইনে রয়েছে | Retry-After এর জন্য অপেক্ষা করুন, অথবা কিছু কাজ শেষ হওয়ার জন্য। |
AUTH_API_KEY_QUOTA_EXCEEDED | কী-এর বাজেট শেষ হয়ে গেছে | বাজেট বাড়ানো না হওয়া পর্যন্ত পুনরায় চেষ্টা করবেন না |
Retry-After ছাড়া 429 কে এক্সপোনেনশিয়াল ব্যাকঅফ দিয়ে পরিচালনা করা উচিত।
পুনরায় চেষ্টা করার কৌশল
Section titled “পুনরায় চেষ্টা করার কৌশল”- ক্যোয়ারিজগুলি সরাসরি পুনরায় চেষ্টা করা যেতে পারে।
- একটি তৈরির অনুরোধ পুনরায় চেষ্টা করার সময়, একই
Idempotency-Keyএবং ঠিক একই বডি ব্যবহার করুন; প্রতিটি নতুন জমা দেওয়ার জন্য একটি নতুন কী ব্যবহার করুন। - অসফল আপলোডের পর, একটি নতুন আপলোড ঠিকানা চান।
- প্রতিটি অনুরোধের জন্য সংযোগ, পাঠ এবং মোট সময়সীমা নির্ধারণ করুন, পুনরায় চেষ্টা করার সময় একটি এলোমেলো ঝাঁকুনি যোগ করুন এবং চেষ্টার সংখ্যা সীমাবদ্ধ করুন।
import randomimport time
for attempt in range(5): response = call_api() if response.status_code not in {429, 500, 502, 503, 504}: break if response.status_code == 429 and response.json().get("code") == "AUTH_API_KEY_QUOTA_EXCEEDED": break retry_after = response.headers.get("Retry-After") delay = float(retry_after) if retry_after else min(2 ** attempt, 16) time.sleep(delay + random.random())