دليل HTTP و APIs الشامل

البروتوكول، الطلبات، و REST APIs

فهرس الدليل

دليل شامل

HTTP & APIs: البروتوكول والواجهات

📅 22 أغسطس 2026 | ️ 20 دقيقة قراءة

HTTP هو البروتوكول الأساسي للاتصال بين المتصفحات والخوادم. APIs تسمح للتطبيقات بالتواصل وتبادل البيانات.

🔍 الجزء الأول: مقدمة عن HTTP

1.1 ما هو HTTP؟

HTTP تعني HyperText Transfer Protocol. هو بروتوكول نقل البيانات على الويب.

💡 خلاصة:

  • ✅ HTTP هو أساس كل اتصال ويب.

📡 الجزء الثاني: طرق HTTP (Methods)

2.1 الطرق الأساسية

GET    - استرجاع بيانات
POST   - إنشاء بيانات جديدة
PUT    - تحديث بيانات كاملة
PATCH  - تحديث جزئي
DELETE - حذف بيانات

2.2 GET - استرجاع البيانات

curl https://api.example.com/users
GET /users HTTP/1.1
Host: api.example.com

2.3 POST - إرسال البيانات

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"Ahmed","email":"ahmed@email.com"}'

💡 خلاصة:

  • ✅ GET للاسترجاع، POST للإنشاء، PUT للتحديث، DELETE للحذف.

📊 الجزء الثالث: رموز الحالة (Status Codes)

3.1 أهم الرموز

200 OK         - نجاح الطلب
201 Created    - تم الإنشاء
400 Bad Request - طلب خاطئ
401 Unauthorized - غير مصرح
404 Not Found  - غير موجود
500 Internal Server Error - خطأ في الخادم

خلاصة:

  • ✅ 2xx نجاح، 4xx خطأ من العميل، 5xx خطأ من الخادم.

🔐 الجزء الرابع: الترويسات (Headers)

4.1 الترويسات الأساسية

curl https://api.example.com/users \
  -H "Authorization: Bearer TOKEN123" \
  -H "Accept: application/json"

💡 خلاصة:

  • ✅ Authorization للمصادقة، Content-Type لنوع البيانات.

الجزء الخامس: REST APIs

5.1 مبادئ REST

# RESTful API Example

GET    /users          # قائمة جميع المستخدمين
GET    /users/1        # المستخدم رقم 1
POST   /users          # إنشاء مستخدم جديد
PUT    /users/1        # تحديث المستخدم 1
DELETE /users/1        # حذف المستخدم 1

💡 خلاصة:

  • ✅ REST يستخدم HTTP Methods للتعامل مع الموارد (Resources).

📋 الجزء السادس: الملخص السريع

الطريقة الاستخدام
GETاسترجاع بيانات
POSTإنشاء بيانات
PUTتحديث كامل
PATCHتحديث جزئي
DELETEحذف بيانات

🎉 مبارك!

أصبحت الآن تفهم أساسيات HTTP و APIs.

تم نسخ الرابط!