الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
v3.0.0 - أكتوبر 2025

تغييرات جوهرية: v3 إعادة تصميم كاملة. راجع دليل الهجرة للحصول على تعليمات الترقية.

​
🔴 ما يجب عليك تغييره

1. تغيير عنوان URL الأساسي

- https://flexy-api.oneclickdz.com/v2
+ https://api.oneclickdz.com/v3

2. تغيير رأس المصادقة

- Authorization: your-api-key
+ X-Access-Token: your-api-key

3. تغيير هيكل الاستجابة

جميع الاستجابات مُغلَّفة الآن في تنسيق موحّد:قبل (v2):
{
  "balance": 50000,
  "currency": "DZD"
}
بعد (v3):
{
  "success": true,
  "data": {
    "balance": 50000,
    "currency": "DZD"
  },
  "meta": {
    "timestamp": "2025-10-29T00:00:00.000Z"
  },
  "requestId": "req_abc123"
}
ادخل إلى البيانات عبر response.data بدلاً من الوصول المباشر من الاستجابة.

4. تغيير مسارات الـ endpoints

الـ endpoint في v2الـ endpoint في v3
/topup/plans/mobile/plans
/topup/send/mobile/send
/topup/check/:id/mobile/check/:id
/plans/internet/internet/products
/topup/sendInternet/internet/send
/account/info/account/balance

5. تغيير معالجة الأخطاء

قبل (v2):
{
  "error": "Insufficient balance"
}
بعد (v3):
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your balance is insufficient for this operation",
    "details": {
      "required": 1000,
      "available": 500
    }
  },
  "requestId": "req_abc123"
}
تحقق دائماً من القيمة المنطقية response.success أولاً.

​
✨ الجديد

  • API بطاقات الهدايا: نظام تسليم بطاقات هدايا كامل مع أكثر من 100 منتج
  • مفاتيح Sandbox: مفاتيح API منفصلة للاختبار دون التأثير على رصيد الإنتاج
  • القائمة البيضاء لعناوين IP: أمان معزّز من خلال إعدادات لوحة التحكم
  • تتبع الطلبات: كل طلب يتضمن requestId فريداً لأغراض التصحيح
  • أخطاء أفضل: أكواد خطأ منظّمة مع رسائل قابلة للتنفيذ
  • التحقق من المخطط: التحقق التلقائي يمنع الطلبات غير الصالحة

​
📅 الموعد النهائي للهجرة

ستُوقَف v2 في 30 أكتوبر 2026. انتقل قبل هذا التاريخ لتجنب انقطاع الخدمة.

​
🔗 الموارد

​
v2.x - ما قبل أكتوبر 2025

​
أغسطس 2025

  • إضافة وضع sandbox للاختبار
  • تحسين معالجة الأخطاء والتسجيل

​
يوليو 2023

  • التطبيق الأولي للـ sandbox
  • إضافة دعم لشحن إنترنت ADSL

​
سابقاً

  • شحن الجوال لـ Mobilis وDjezzy وOoredoo
  • تتبع المعاملات الأساسي
  • إدارة رصيد الحساب

​
تحتاج مساعدة؟

تواصل مع الدعم

أسئلة حول الهجرة؟ نحن هنا للمساعدة.