راهنما

آموزش کار با API در پایتون | پروژه عملی

ایجاد یک پروژه ساده با استفاده از API

برای شروع یک پروژه عملی با API، ابتدا باید یک API عمومی و رایگان انتخاب کنید. به عنوان مثال، از API هواشناسی OpenWeatherMap یا API نمایش نقل‌قول‌های تصادفی مثل quotable.io استفاده می‌کنیم. در این بخش، هدف ما ایجاد یک اسکریپت پایتونی است که یک درخواست به API بزند و نتیجه را در خروجی نمایش دهد.

مراحل ایجاد پروژه:

انتخاب API و دریافت URL
هر API یک آدرس پایه (Base URL) دارد. برای مثال، API نقل‌قول‌های تصادفی از آدرس زیر استفاده می‌کند:
https://api.quotable.io/random
این آدرس مستقیماً یک نقل‌قول تصادفی را برمی‌گرداند.
نوشتن کد اولیه
با استفاده از کتابخانه requests (که در پایتون داخلی نیست اما در بسیاری از محیط‌های آنلاین پیش‌فرض است)، کد زیر را می‌نویسیم:

import requests

# ارسال درخواست GET به API
response = requests.get("https://api.quotable.io/random")

# بررسی وضعیت پاسخ
if response.status_code == 200:
    # تبدیل پاسخ JSON به دیکشنری
    data = response.json()

    # استخراج اطلاعات مورد نظر (در اینجا محتوای نقل‌قول و نویسنده)
    quote = data["content"]
    author = data["author"]

    # چاپ نتیجه
    print(f"نقل‌قول: {quote}")
    print(f"نویسنده: {author}")
else:
    print(f"خطا: {response.status_code}")

توضیح خط به خط کد
- import requests: کتابخانه لازم برای ارسال درخواست HTTP را فراخوانی می‌کند.
- requests.get(...): یک درخواست GET به آدرس API می‌فرستد.
- response.status_code: کد وضعیت HTTP را برمی‌گرداند (200 یعنی موفق).
- response.json(): بدنه پاسخ را که فرمت JSON دارد به یک دیکشنری پایتون تبدیل می‌کند.
- data["content"]: مقدار کلید content را از دیکشنری استخراج می‌کند (در این API، محتوای نقل‌قول).
اجرای کد در ویرایشگر آنلاین
کد بالا را در ویرایشگر آنلاین سایت خود قرار دهید و اجرا کنید. خروجی مشابه زیر خواهید دید:
```
نقل‌قول: زندگی چیزی نیست که به تنهایی می‌توانی انجام دهی.
نویسنده: جان لنون
```
(هر بار اجرا، یک نقل‌قول متفاوت نمایش داده می‌شود.)
افزودن قابلیت ذخیره‌سازی ساده
اگر می‌خواهید نتیجه را در یک فایل متنی ذخیره کنید، کد زیر را به انتهای بخش موفقیت اضافه کنید:

with open("quote.txt", "w", encoding="utf-8") as file:
    file.write(f"نقل‌قول: {quote}\n")
    file.write(f"نویسنده: {author}")

این فایل در کنار برنامه شما ذخیره می‌شود و می‌توانید آن را در ویرایشگر آنلاین مشاهده کنید.

نکته مهم: در این پروژه ساده، از احراز هویت استفاده نکردیم چون API انتخاب شده عمومی و بدون نیاز به کلید است. در پروژه‌های واقعی، ممکن است نیاز به کلید API داشته باشید که در بخش‌های بعدی توضیح داده می‌شود.

پرسش و پاسخ این درس

برای ثبت پرسش ابتدا در سایت وارد شوید.

آموزش کار با API در پایتون | پروژه عملی

خطای دسترسی

ایجاد یک پروژه ساده با استفاده از API

مراحل ایجاد پروژه: