الويب: واجهة برمجية JSON مصغّرة
واجهة الويب البرمجية (API) برنامج يجيب عن الطلبات ببيانات، غالبًا بصيغة JSON. تُنظَّم في مسارات: طريقة + مسار (مثل GET /tasks/2) يشغّلان دالة تعيد رمز حالة ومحتوى.
هذا بالضبط ما تفعله FastAPI وFlask، إضافة إلى الشبكة. العادات الجيدة: 200 عندما يكون كل شيء سليمًا، و404 إن لم يوجد المورد، و405 إن كانت الطريقة غير مسموحة، ودائمًا ردّ JSON مقروء حتى عند الخطأ. وjson.dumps تحوّل كائن Python إلى نص JSON.
import json
users = {1: {"name": "Lina"}, 2: {"name": "Omar"}}
def get_user(user_id):
if user_id in users:
return 200, users[user_id]
return 404, {"error": "user not found"}
for uid in (1, 3):
status, body = get_user(uid)
print(status, json.dumps(body))