آموزش کار با API در پایتون | مدیریت خطاها و استثناها

انواع خطاهای رایج در کار با API

در کار با API، ممکن است با خطاهای مختلفی روبرو شوید. دانستن این خطاها به شما کمک می‌کند تا سریع‌تر مشکل را پیدا و رفع کنید. رایج‌ترین انواع خطاها عبارتند از:

خطاهای اتصال (Connection Errors):
این خطا زمانی رخ می‌دهد که برنامه شما نمی‌تواند به سرور API متصل شود. دلایل آن می‌تواند قطعی اینترنت، آدرس URL اشتباه، یا مسدود بودن دسترسی توسط فایروال باشد. در پایتون، این خطا معمولاً به صورت خطای requests.exceptions.ConnectionError ظاهر می‌شود.

خطاهای زمان‌بندی (Timeout Errors):
اگر سرور API در مدت زمان مشخصی پاسخ ندهد (مثلاً ۵ ثانیه)، خطای timeout رخ می‌دهد. این مشکل معمولاً به دلیل کندی سرور یا ترافیک بالا اتفاق می‌افتد. در کتابخانه requests می‌توانید با پارامتر timeout زمان انتظار را تنظیم کنید.

خطاهای HTTP (HTTP Status Codes):
سرور API با یک کد وضعیت HTTP پاسخ می‌دهد که نشان‌دهنده موفقیت یا شکست درخواست شماست. رایج‌ترین کدهای خطا عبارتند از:

• ۴۰۱ (Unauthorized): نشان می‌دهد شما اجازه دسترسی ندارید و معمولاً نیاز به احراز هویت دارید.
• ۴۰۳ (Forbidden): دسترسی شما به این منبع ممنوع است، حتی با احراز هویت.
• ۴۰۴ (Not Found): آدرس API یا منبع درخواستی شما وجود ندارد.
• ۴۲۹ (Too Many Requests): شما تعداد درخواست‌های زیادی در مدت زمان کوتاه ارسال کرده‌اید (محدودیت نرخ).
• ۵۰۰ (Internal Server Error): مشکل در سمت سرور API رخ داده است.

خطاهای تجزیه داده (Parsing Errors):
اگر API داده‌ای را برگرداند که قابل تجزیه نباشد (مثلاً JSON خراب یا فرمت نادرست)، خطا ایجاد می‌شود. این خطا معمولاً با json.JSONDecodeError در پایتون ظاهر می‌شود.

خطاهای URL نامعتبر (Invalid URL Errors):
اگر URL وارد شده (مثلاً در تابع requests.get()) شامل نویسه‌های مجاز نباشد یا ساختار نادرست داشته باشد، خطایی مانند requests.exceptions.InvalidURL رخ می‌دهد.

خطاهای مربوط به احراز هویت (Authentication Errors):
این خطا زمانی رخ می‌دهد که کلید API یا توکن شما اشتباه، منقضی یا فاقد دسترسی لازم باشد. کد وضعیت معمولاً ۴۰۱ یا ۴۰۳ است.