منصة مطوري KORIXA الإصدار الأول

توثيق واجهة REST API والربط البرمجي

اربط أدوات كوريكسا ومحركات الذكاء الاصطناعي مباشرة مع تطبيقاتك البرمجية، سيرفراتك، وأنظمة الأتمتة السحابية.

نقطة الاتصال الرئيسية

https://korixa.online/api/v1/

المصادقة الأمنية

أرسل مفتاح الـ API الخاص بك في ترويسة الطلب:

Authorization: Bearer <API_KEY>

حدود الاستهلاك اليومية

  • • الباقة المجانية: 10 طلبات / يوم
  • • باقة Pro للمحترفين: 500 طلب / يوم
  • • باقة الشركات: سعة مخصصة ودعم SLA
POST /api/v1/tools/execute
Content-Type: application/json

تنفيذ خوارزميات التنسيق والتدقيق والتشفير والترميز الحسابية فائق السرعة عبر شبكة Cloudflare Edge. الأدوات المدعومة حالياً: json-formatter، json-validator، base64-encoder، base64-decoder، uuid-generator، hash-generator، url-encoder، و url-decoder.

هيكل البيانات المرسلة (Payload)

{
  "toolSlug": "json-formatter" | "json-validator" | "base64-encoder" | "base64-decoder" | "uuid-generator" | "hash-generator" | "url-encoder" | "url-decoder",
  "input": "النص أو البيانات المراد معالجتها",
  "options": {
    "indent": 2 | 4 | "tab",
    "algorithm": "SHA-256" | "SHA-512" | "SHA-1",
    "count": 1
  }
}

مثال الربط البرمجي لتنسيق JSON عبر (cURL)

curl -X POST https://korixa.online/api/v1/tools/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolSlug": "json-formatter",
    "input": "{\"platform\":\"korixa\",\"status\":\"active\"}",
    "options": { "indent": 2 }
  }'

هيكل الاستجابة (HTTP 200 OK)

{
  "success": true,
  "result": "formatted_json_output",
  "meta": {
    "toolSlug": "json-formatter",
    "durationMs": 1.45,
    "timestamp": "2026-09-17T20:55:00.000Z"
  }
}
POST /api/v1/ai/execute
Content-Type: application/json

تنفيذ مهام الذكاء الاصطناعي التوليدية بما في ذلك تلخيص النصوص، الترجمة، شرح الأكواد البرمجية، وتوليد وسوم السيو وتحسين الأوامر التوجيهية عبر شبكة خوادم الحافة.

هيكل البيانات المرسلة (Payload)

{
  "toolSlug": "ai-summarizer" | "ai-translator" | "ai-rewriter" | "ai-code-explainer" | "ai-seo-generator" | "ai-prompt-enhancer",
  "prompt": "النص أو الكود المراد معالجته",
  "lang": "ar" | "en"
}

مثال الربط البرمجي عبر (cURL)

curl -X POST https://korixa.online/api/v1/ai/execute \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "toolSlug": "ai-summarizer",
    "prompt": "قم بتلخيص هذا النص التقني...",
    "lang": "ar"
  }'

هيكل الاستجابة (HTTP 200 OK)

{
  "success": true,
  "result": "النتيجة المعالجة والمستخرجة من النموذج...",
  "meta": {
    "toolSlug": "ai-summarizer",
    "provider": "UnoRouter" | "Cloudflare Workers AI",
    "durationMs": 380
  }
}

أكواد حالة الاستجابة القياسية (Status Codes)

200 OK تمت معالجة الطلب بنجاح وإرجاع النتيجة.
400 Bad Request بيانات JSON غير صالحة أو نقص في الحقول المطلوبة.
429 Rate Limited تجاوز الحد اليومي للاستهلاك. قم بالترقية لـ Pro.
500 Server Error خطأ داخلي في الخادم تم تداركه ومعالجته بأمان.