> ## 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.

# سجل التغييرات

> تحديثات API والتغييرات الجوهرية

<div dir="rtl">
  ## v3.0.0 - أكتوبر 2025

  <Warning>
    **تغييرات جوهرية**: v3 إعادة تصميم كاملة. راجع [دليل الهجرة](/ar/migration-from-v2) للحصول على تعليمات الترقية.
  </Warning>

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

  <AccordionGroup>
    <Accordion icon="globe" title="1. تغيير عنوان URL الأساسي" defaultOpen>
      ```diff theme={null}
      - https://flexy-api.oneclickdz.com/v2
      + https://api.oneclickdz.com/v3
      ```
    </Accordion>

    <Accordion icon="key" title="2. تغيير رأس المصادقة" defaultOpen>
      ```diff theme={null}
      - Authorization: your-api-key
      + X-Access-Token: your-api-key
      ```
    </Accordion>

    <Accordion icon="code" title="3. تغيير هيكل الاستجابة" defaultOpen>
      جميع الاستجابات مُغلَّفة الآن في تنسيق موحّد:

      **قبل (v2):**

      ```json theme={null}
      {
        "balance": 50000,
        "currency": "DZD"
      }
      ```

      **بعد (v3):**

      ```json theme={null}
      {
        "success": true,
        "data": {
          "balance": 50000,
          "currency": "DZD"
        },
        "meta": {
          "timestamp": "2025-10-29T00:00:00.000Z"
        },
        "requestId": "req_abc123"
      }
      ```

      ادخل إلى البيانات عبر `response.data` بدلاً من الوصول المباشر من الاستجابة.
    </Accordion>

    <Accordion icon="route" title="4. تغيير مسارات الـ endpoints" defaultOpen>
      | الـ 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`   |
    </Accordion>

    <Accordion icon="triangle-exclamation" title="5. تغيير معالجة الأخطاء" defaultOpen>
      **قبل (v2):**

      ```json theme={null}
      {
        "error": "Insufficient balance"
      }
      ```

      **بعد (v3):**

      ```json theme={null}
      {
        "success": false,
        "error": {
          "code": "INSUFFICIENT_BALANCE",
          "message": "Your balance is insufficient for this operation",
          "details": {
            "required": 1000,
            "available": 500
          }
        },
        "requestId": "req_abc123"
      }
      ```

      تحقق دائماً من القيمة المنطقية `response.success` أولاً.
    </Accordion>
  </AccordionGroup>

  ### ✨ الجديد

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

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

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

  ### 🔗 الموارد

  * [دليل الهجرة الكامل](/ar/migration-from-v2)
  * [مرجع API v3](/ar/api-reference/response-format)
  * [دليل المصادقة](/ar/authentication)

  ***

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

  ### أغسطس 2025

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

  ### يوليو 2023

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

  ### سابقاً

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

  ***

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

  <Card title="تواصل مع الدعم" icon="headset" href="/ar/contact">
    أسئلة حول الهجرة؟ نحن هنا للمساعدة.
  </Card>
</div>