مرجع API
مرجع لكل نقطة نهاية في X114 API: المصادقة، مخطط الطلب، مخطط الاستجابة، ومثال curl عامل.
عنوان URL الأساسي
كل النقاط النهائية تقع تحت نفس عنوان URL الأساسي. استخدم HTTPS في الإنتاج.
https://x114.org/api/v1المصادقة
كل طلب يحتاج إلى Bearer token. أنشئ واحدًا في الإعدادات → مفاتيح API بعد التسجيل.
Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxالأرصدة
كل استدعاء يكلّف رصيدًا واحدًا. الرصيد غير الكافي يُرجع 402. الأرصدة لا تنتهي صلاحيتها في خطة Lifetime.
رموز الحالة
نفس الشكل يُستخدم لكل نقطة نهاية.
| الرمز | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح. |
| 402 | أرصدة غير كافية — اشحن من لوحة التحكم. |
| 429 | تجاوز حد المعدل — تراجع وأعد المحاولة. |
| 500 | خطأ في الخادم — آمن إعادة المحاولة مع تراجع. |