واجهة المطورين

واجهة REST للقراءة فقط، الإصدار v1. تعرض ما يراه الزائر غير المسجل فقط — لا بيانات خاصة ولا رسائل ولا أقسام مقيدة ولا اختبارات مخفية.

نقاط الوصول

GET /api/v1/codes?page=&language= — الأكواد المعتمدة (بيانات وصفية)
GET /api/v1/codes/{slug} — كود معتمد مع ملفات أحدث إصدار معتمد
GET /api/v1/topics?page=&forum= — مواضيع الأقسام العامة فقط
GET /api/v1/challenges?page= — التحديات مع الأمثلة الظاهرة فقط

الرد: { data, page, pages, total } بصيغة JSON، 20 عنصراً في الصفحة. الأخطاء: { error: { code, message } }.

الحدود والمفاتيح

دون مفتاح: 60 طلباً في الدقيقة لكل عنوان IP.
بمفتاح: 600 طلب في الدقيقة. أنشئ المفتاح من الإعدادات وأرسله في الترويسة Authorization: Bearer ac_….
الترويستان x-ratelimit-limit وx-ratelimit-remaining مع كل رد، و429 عند التجاوز.
CORS مفتوح للقراءة (GET) دون ملفات تعريف الارتباط؛ لا تضع مفتاحك في كود يعمل في المتصفح.

curl -H "Authorization: Bearer $ARABCODE_KEY" \
  "https://arab-code.x-host.site/api/v1/codes?language=python&page=1"

تضمين الأكواد في موقعك

أي كود معتمد يمكن تضمينه بإطار للقراءة فقط، مع زر نسخ ونسبة المصدر. السمة: ?theme=light أو dark.

<iframe src="https://arab-code.x-host.site/embed/c/{slug}?theme=dark"
        style="width:100%;height:360px;border:0;border-radius:12px"
        loading="lazy" title="كود من عرب كود"></iframe>