کار با درخواست‌های HTTP و کتابخانه Requests

# Static: Installation command
# در ترمینال یا خط فرمان اجرا کنید:
pip install requests

# Static (External Library): Simple GET request
import requests

# ارسال درخواست به یک API نمونه
response = requests.get('https://jsonplaceholder.typicode.com/posts/1')

# بررسی کد وضعیت (200 یعنی موفقیت‌آمیز)
if response.status_code == 200:
    print("Success!")
    # دسترسی به متن پاسخ
    print(response.text)
else:
    print("Failed")

# Static (External Library): Handling JSON
import requests

response = requests.get('https://jsonplaceholder.typicode.com/users/1')

# تبدیل خودکار JSON به دیکشنری
data = response.json()

print(f"Name: {data['name']}")
print(f"Email: {data['email']}")

# Static (External Library): Advanced GET with headers
import requests

url = "https://jsonplaceholder.typicode.com/comments"

# پارامترهایی که به صورت ?postId=1 به URL اضافه می‌شوند
query_params = {
    "postId": 1
}

# هدرها برای شبیه‌سازی مرورگر یا ارسال توکن
headers = {
    "User-Agent": "MyPythonApp/1.0",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN" # مثال برای احراز هویت
}

response = requests.get(url, params=query_params, headers=headers)

print(f"URL Called: {response.url}")
# خروجی احتمالی: https://jsonplaceholder.typicode.com/comments?postId=1

# Static (External Library): POST request
import requests

url = "https://jsonplaceholder.typicode.com/posts"

payload = {
    "title": "Home of Python",
    "body": "Learning Requests library",
    "userId": 1
}

# ارسال به صورت JSON
response = requests.post(url, json=payload)

# کد 201 معمولاً به معنای "ایجاد موفق" است
if response.status_code == 201:
    print("Created successfully:", response.json())

# Static (External Library): Robust Error Handling
import requests
from requests.exceptions import Timeout, RequestException

url = "https://jsonplaceholder.typicode.com/posts/1"

try:
    # timeout=5 یعنی اگر تا ۵ ثانیه جوابی نیامد، خطا بده
    response = requests.get(url, timeout=5)
    
    # اگر کد وضعیت 4xx یا 5xx باشد، خطا پرتاب می‌کند
    response.raise_for_status()
    
    data = response.json()
    print("Data received:", data['id'])

except Timeout:
    print("خطا: سرور در زمان مشخص شده پاسخ نداد.")
except RequestException as e:
    print(f"خطای کلی در ارتباط: {e}")

# Static (External Library): Using Session
import requests

# ایجاد یک نشست (Session)
with requests.Session() as s:
    # تنظیم هدر یا کوکی مشترک برای تمام درخواست‌ها
    s.headers.update({'x-test': 'true'})
    
    # درخواست اول (Login فرضی)
    s.get('https://httpbin.org/cookies/set/sessioncookie/123456789')
    
    # درخواست دوم (Profile) - کوکی‌های درخواست قبل اینجا ارسال می‌شوند
    resp = s.get('https://httpbin.org/cookies')
    
    print(resp.json())