Requests

پرکاربردترین کتابخانه HTTP پایتون

۴.۹۲ از ۵ پایتون

این کتابخانه چیست و چه می‌کند؟

Requests ساده‌ترین راه صدا زدن APIها و دانلود صفحات وب در پایتون است؛ شعار رسمی‌اش «HTTP for Humans» است و کاملاً برقرار است: یک خط کد برای درخواست GET و پاسخ کامل با هدر، متن و JSON. تقریباً همه پروژه‌های پایتونی که با اینترنت سر و کار دارند از requests استفاده می‌کنند و یادگیری آن اولین قدم ورود به دنیای APIهاست.

قابلیت‌های کلیدی

  • درخواست GET/POST با یک خط
  • پارس خودکار JSON با response.json()
  • مدیریت کوکی، هدر و احراز هویت
  • تایم‌اوت و رتری نرم و ساده

مثال کاربردی واقعی

قابل اجرا
import requests

resp = requests.get('https://api.github.com/repos/python/cpython')
if resp.status_code == 200:
    data = resp.json()
    print('ستاره‌ها:', data['stargazers_count'])

# ارسال داده با POST
answer = requests.post('https://httpbin.org/post', json={'name': 'علی'})
print(answer.json()['json'])

توضیح مثال: درخواست GET اطلاعات مخزن پایتون را می‌گیرد و JSON را پارس می‌کند؛ سپس یک POST با بدنه JSON ارسال می‌شود. همیشه status_code را چک کنید و در کد واقعی تایم‌اوت هم بدهید: requests.get(url, timeout=10).

نکات حرفه‌ای

  • همیشه timeout بدهید تا برنامه برای همسر در انتظار پاسخ نماند.
  • برای APIهای احراز هویت‌دار از headers={\"Authorization\": ...} استفاده کنید.