وَثائق المُطَوِّرين

البِدايَة السَّريعَة

احصُل عَلى API key من حِسابِك، ثُمَّ أَرسِل أَوَّل طَلَب:

curl https://api.swasena.com/v1/chat/completions \
  -H "Authorization: Bearer $SWASENA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "swasena",
    "messages": [
      {"role": "user", "content": "اشرح زكاة الشركات بإيجاز"}
    ]
  }'

الـ Endpoints

أَمثِلَة بِالـ Python

import openai

client = openai.OpenAI(
    api_key="YOUR_SWASENA_API_KEY",
    base_url="https://api.swasena.com/v1"
)

response = client.chat.completions.create(
    model="swasena",
    messages=[
        {"role": "user", "content": "ما هي ضوابط NCA الأساسية؟"}
    ]
)

print(response.choices[0].message.content)

المُصادَقَة

أَرسِل الـ API key في الـ Authorization header مَع كُلّ طَلَب:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

حُدود الاستِخدام

أَكواد الخَطَأ

200  OK              نَجاح
400  Bad Request     الطَّلَب غَير صَحيح
401  Unauthorized    API key غَير صَحيح
403  Forbidden       لا تَملِك صَلاحيّة لِهذا الوَكيل
429  Rate Limited    تَجاوَزت حُدود الاستِخدام
500  Server Error    خَطَأ في السيرفِر — تَواصَل مَعَنا

SDK

نَستَخدِم نَفس نَسَق OpenAI، فَأَيّ SDK مَكتوب لِـ OpenAI يَعمَل مَعَنا: