أساسيات HTTP

HTTP (بروتوكول نقل النص التشعبي) هو كيف يتحدث كودك مع خدمات الذكاء الاصطناعي. فهمه ضروري للعمل مع أي API.

نموذج الطلب-الاستجابة

الكود الخاص بك  ──[طلب]──>  خادم API
               <──[استجابة]──

كل تفاعل مع API يتبع هذا النمط:

الكود الخاص بك يرسل طلباً
الخادم يعالجه
الخادم يُرجع استجابة

طرق HTTP

الطريقة	الغرض	حالة استخدام الذكاء الاصطناعي
GET	استرداد البيانات	عرض النماذج، فحص الحالة
POST	إرسال البيانات	إكمالات المحادثة، التضمينات
PUT	تحديث البيانات	تحديث النماذج المُضبطة
DELETE	إزالة البيانات	حذف الملفات، إلغاء المهام

معظم استدعاءات AI API تستخدم POST لأنك ترسل مطالبات/رسائل.

بنية الطلب

POST /v1/chat/completions HTTP/1.1
Host: api.openai.com
Authorization: Bearer sk-your-key
Content-Type: application/json

{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "مرحباً!"}]
}

المكونات الرئيسية:

الطريقة + المسار: أي إجراء وأين
الترويسات: بيانات وصفية (المصادقة، نوع المحتوى)
الجسم: البيانات الفعلية (JSON لواجهات AI)

بنية الاستجابة

HTTP/1.1 200 OK
Content-Type: application/json

{
    "choices": [
        {"message": {"content": "مرحباً! كيف يمكنني المساعدة؟"}}
    ]
}

أكواد حالة HTTP

الكود	المعنى	ماذا تفعل
200	نجاح	معالجة الاستجابة
400	طلب سيء	تحقق من تنسيق طلبك
401	غير مصرح	تحقق من مفتاح API
429	حد المعدل	انتظر وأعد المحاولة
500	خطأ الخادم	أعد المحاولة أو اتصل بالدعم

الترويسات التي ستستخدمها كثيراً

headers = {
    "Authorization": "Bearer sk-your-api-key",
    "Content-Type": "application/json",
    "Accept": "application/json"
}