محتوای آموزشی وبلاگ نتآرام
برنامه پایتون شما هنگام تماس با یک API مدت زیادی منتظر میماند. صفحه کاربر بارگذاری نمیشود یا کار زمانبندیشده تمام نمیشود. اگر در درخواست زمان انتظار مشخص نکرده باشید، ممکن است برنامه برای پاسخ بسیار طولانی منتظر بماند. از طرف دیگر، گذاشتن یک عدد کوتاه و تکرار بیپایان درخواست هم میتواند مشکل را بیشتر کند.
در این آموزش اتصال به سرور و دریافت پاسخ را جدا میکنیم، برای هرکدام زمان مناسب میگذاریم و خطا را به زبان ساده مدیریت میکنیم. مثالها برای کتابخانه
requests و یک API آزمایشی بیخطر هستند. اگر برنامه شما از کتابخانه دیگری مانند httpx یا یک SDK استفاده میکند، نام گزینهها و رفتار دقیق آن ممکن است متفاوت باشد.۱. مطمئن شوید مشکل در کدام تماس است
زمان درخواست، نام سرویس مقصد بدون رمز و اینکه عملیات چه کاری انجام میدهد را در گزارش خصوصی ثبت کنید. مشخص کنید برنامه در همه درخواستها کند است یا فقط یک API خاص. آدرس حاوی توکن، بدنه خصوصی و سرآیند Authorization را در لاگ عمومی قرار ندهید.
در پنل هاست پایتون، برنامه و فرمان فعالسازی محیط مجازی آن را پیدا کنید. در Terminal یا SSH همان حساب، وارد پوشه پروژه شوید و نسخهها را ببینید:
کد / دستورcd ~/myproject
python --version
python -m pip show requests
مسیر پروژه نمونه است. اگر بسته پیدا نشد، ابتدا محیط درست را فعال کنید؛ راهنمای ModuleNotFoundError تفاوت محیطها را توضیح میدهد. از نصب تصادفی بسته روی مفسر سیستم یا اجرای sudo در هاست اشتراکی خودداری کنید.
۲. زمان اتصال و زمان خواندن چه فرقی دارند؟
connect timeout محدودیتی برای تلاش اتصال به مقصد است. read timeout به انتظار برای رسیدن داده از طرف مقابل مربوط میشود. در requests، این عدد معمولاً فاصله انتظار برای داده روی اتصال است و یک سقف تضمینی برای کل مدت دانلود نیست؛ پاسخ طولانی که مرتب داده میفرستد میتواند بیشتر از آن طول بکشد. همچنین مرحلههایی مانند حل DNS، تلاش روی چند آدرس یا انتقالها ممکن است مدت کل را بیشتر کنند.عدد مناسب به نیاز سرویس و کیفیت شبکه بستگی دارد. برای یک API سریع ممکن است چند ثانیه مناسب باشد؛ برای عملیات سنگین یا انتقال فایل باید طراحی متفاوتی در نظر گرفت. از عدد مثال بهعنوان استاندارد ثابت همه سرویسها استفاده نکنید.
۳. یک درخواست آزمایشی با timeout بسازید
در نسخه آزمایشی، نشانی را به مسیر سلامت عمومی و بیخطر خودتان تغییر دهید:
کد / دستورimport requests
response = requests.get(
"https://api.example.com/health",
timeout=(3.05, 10),
)
response.raise_for_status()
print("status:", response.status_code)
در این مثال
3.05 ثانیه برای اتصال و 10 ثانیه برای انتظار خواندن است. raise_for_status() پاسخ خطای HTTP مانند ۴۰۴ یا ۵۰۰ را به خطای قابل رسیدگی تبدیل میکند. این دو عدد نمونهاند؛ قبل از استفاده در سرویس واقعی با شرایط مقصد و زمان قابل قبول کاربر تنظیم و آزمونشان کنید. مقدار ثابت برای timeout کل پروژه را بدون شناخت همه تماسها تغییر ندهید.اگر میخواهید نتیجه را به عنوان اسکریپت امتحان کنید، آن را در یک فایل آزمایشی در پوشه خصوصی پروژه قرار دهید و با مفسر محیط همان برنامه اجرا کنید:
کد / دستورpython check_api.py
نام
check_api.py را با نام واقعی فایل آزمایش عوض کنید. درخواست را به عملیات مالی یا ثبت داده متصل نکنید.۴. خطاها را جداگانه مدیریت کنید
نمونه زیر علتهای رایج را جدا میکند و فقط پیام کلی چاپ میکند:
کد / دستورimport requests
try:
response = requests.get("https://api.example.com/health", timeout=(3.05, 10))
response.raise_for_status()
print("API responded:", response.status_code)
except requests.ConnectTimeout:
print("اتصال در زمان تعیینشده برقرار نشد")
except requests.ReadTimeout:
print("پس از اتصال، داده در زمان تعیینشده نرسید")
except requests.exceptions.SSLError:
print("بررسی گواهی TLS ناموفق بود")
except requests.ConnectionError:
print("اتصال شبکه برقرار نشد یا قطع شد")
except requests.HTTPError as exc:
print("HTTP error:", exc.response.status_code if exc.response is not None else "unknown")
ترتیب رسیدگی اهمیت دارد؛ برای مثال
SSLError از خانواده خطاهای اتصال است و باید پیش از رسیدگی عمومی ConnectionError بررسی شود. در برنامه واقعی نتیجه خطا را به شکلی مناسب و بدون لو دادن جزئیات داخلی به کاربر نشان دهید. این نمونه همه خطاهای ممکن یا سقف زمان کل فرآیند را پوشش نمیدهد.۵. اگر اتصال یا TLS مشکل دارد
از همان محیط و با یک نشانی عمومی آزمایشی، پاسخ پایه را ببینید:
کد / دستورcurl -I https://api.example.com/health
اگر curl هم نمیتواند نام را پیدا کند یا اتصال برقرار کند، مشکل ممکن است شبکه، DNS، فایروال یا مقصد باشد. اگر فقط برنامه مشکل دارد، نسخه کتابخانه و تنظیم گواهی مورد اعتماد آن را بررسی کنید. موفقیت curl بهتنهایی اثبات نمیکند requests از همان مخزن گواهی یا همان تنظیم پراکسی استفاده میکند. برای رفع خطای گواهی،
verify=False را به راهحل دائمی تبدیل نکنید؛ علت نامعتبر بودن زنجیره یا اعتماد را درست کنید.اگر اتصال برقرار میشود ولی
ReadTimeout میگیرید، زمان اجرای سرویس مقصد و محدودیتهای آن را با مسئول API مقایسه کنید. گاهی پاسخ واقعاً به زمان بیشتری نیاز دارد؛ گاهی API گیر کرده یا یک درخواست بزرگ باید به کار پسزمینه مناسب تبدیل شود. در هاست اشتراکی قابلیت اجرای Worker دائمی به سرویس و پلن وابسته است.۶. درخواست را فقط با آگاهی تکرار کنید
برای یک GET سلامت بیخطر، تعداد محدود تلاش مجدد همراه فاصله و ثبت نتیجه میتواند به قطعی کوتاه کمک کند. برای پرداخت، ساخت سفارش یا هر درخواست دارای اثر، خطای timeout ثابت نمیکند سرور مقصد عملیات را انجام نداده است. تکرار کورکورانه ممکن است تراکنش را دوباره ثبت کند. در چنین مسیرهایی باید از سازوکار idempotency و بررسی وضعیت مقصد طبق مستندات همان API استفاده کنید.
پس از تغییر، یک پاسخ سریع، یک تأخیر آزمایشی و یک خطای کنترلشده را در محیط تست امتحان کنید. ببینید برنامه در زمان قابل قبول پاسخ مناسب میدهد و اطلاعات محرمانه در گزارش نیست. امکانات میزبانی را در هاست پایتون نتآرام و توضیح دقیق رفتار timeout را در مستند رسمی requests ببینید.
برچسبها:
اشتراکگذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله بعدی
دیدگاهها (۰)
دیدگاههای تاییدشده و پاسخهای تیم نتآرام
