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

# مقدمة

> واجهة برمجة تطبيقات شاملة لخدمات الاتصالات في الجزائر - شحن الهاتف والإنترنت وبطاقات الهدايا

## OneClickDz Flexy API v3

OneClick هو الموزع الرسمي لـ Algérie Télécom وDjezzy، والمنصة الرقمية الوحيدة في الجزائر التي تجمع تحت سقف واحد: شحن الهاتف، بطاقات الإنترنت، والقسائم الرقمية الدولية (PlayStation، Steam، Xbox، إلخ).
تتيح واجهتنا البرمجية للشركات دمج هذه الخدمات مباشرةً في مواقعها أو تطبيقاتها أو أنظمة نقاط البيع - مع توصيل فوري ومدفوعات آمنة.

**مصممة للمطورين** باستجابات موحدة ومعالجة شاملة للأخطاء وتوثيق تفصيلي.

## التنقل السريع

<CardGroup cols={2}>
  <Card title="دليل البدء السريع" icon="rocket" href="/ar/quickstart">
    ابدأ في أقل من 5 دقائق
  </Card>

  <Card title="شحن الهاتف" icon="mobile" href="/ar/mobile-topup-guides/overview">
    سير عمل شحن الهاتف الكامل
  </Card>

  <Card title="شحن الإنترنت" icon="wifi" href="/ar/internet-topup-guides/overview">
    دليل شحن ADSL و4G
  </Card>

  <Card title="بطاقات الهدايا" icon="gift" href="/ar/gift-card-guides/overview">
    سير عمل توصيل المنتجات الرقمية
  </Card>

  <Card title="Navio" icon="credit-card" href="/ar/ocpay-guides/overview">
    تكامل بوابة الدفع
  </Card>
</CardGroup>

## خدماتنا

### شحن الهاتف

أرسل شحنات فورية إلى جميع شبكات الهاتف الجزائرية مع تتبع الحالة في الوقت الفعلي.

**الشبكات المدعومة:**

* Mobilis (مسبق الدفع، لاحق الدفع، ثابت)
* Djezzy (مسبق الدفع، لاحق الدفع، ثابت)
* Ooredoo (مسبق الدفع، لاحق الدفع، ثابت)

**المميزات:**

* خطط بمبالغ ثابتة وديناميكية
* شحن فوري أو مجدول
* استرداد تلقائي عند الفشل
* تتبع الحالة بمراجع فريدة

[عرض مرجع API للهاتف ←](/ar/api-reference/mobile/list-plans)

### شحن الإنترنت

اشحن خطوط ADSL و4G LTE فوراً مع التحقق من رقم الهاتف.

**الخدمات:**

* شحن ADSL
* شحن 4G LTE
* فئات متعددة من البطاقات
* توفر المخزون في الوقت الفعلي

**المميزات:**

* التحقق من الرقم قبل الشراء
* شحن فوري باستخدام رقم الهاتف فقط
* تتبع المعاملات

[عرض مرجع API للإنترنت ←](/ar/api-reference/internet/list-products)

### بطاقات الهدايا والمنتجات الرقمية

سلّم بطاقات الهدايا والقسائم الرقمية فوراً مع كتالوج منتجات شامل.

**الفئات:**

* بطاقات الألعاب (Freefire، Pubg، PSN، Xbox، Steam...)
* خدمات البث (Shahid...)
* المحافظ الرقمية (iTunes، Amazon...)
* بطاقات شحن الهاتف
* والمزيد...

**المميزات:**

* أكثر من 100 منتج متاح
* فحص المخزون في الوقت الفعلي
* توصيل رقمي فوري
* دعم الطلبات بالجملة

[عرض مرجع API لبطاقات الهدايا ←](/ar/api-reference/gift-cards/get-catalog)

### Navio - بوابة الدفع

اقبل المدفوعات الإلكترونية من عملائك عبر حل بوابة الدفع المتكاملة.

**طرق الدفع:**

* CIB (بطاقات الائتمان)
* eDahabia (بطاقة الدفع الوطنية)

**المميزات:**

* إنشاء روابط دفع بسيط
* طرق دفع متعددة في تكامل واحد
* تتبع حالة الدفع في الوقت الفعلي
* التحقق التلقائي من المدفوعات
* معالجة آمنة للمعاملات
* دعم المبالغ المخصصة

**حالات الاستخدام:**

* تكامل الدفع في التجارة الإلكترونية
* مدفوعات الاشتراكات في الخدمات
* تحصيل مدفوعات الفواتير
* التبرعات وجمع التمويل
* بيع تذاكر الفعاليات

[عرض مرجع API لـ Navio ←](/ar/api-reference/ocpay/create-link)

## لماذا تختار واجهتنا البرمجية؟

<CardGroup cols={2}>
  <Card title="استجابات موحّدة" icon="code">
    هيكل JSON متسق عبر جميع الـ endpoints مع حقول `success` و`data` و`meta` و`requestId`
  </Card>

  <Card title="معالجة شاملة للأخطاء" icon="shield-check">
    أكواد أخطاء واضحة ورسائل تفصيلية وإرشادات قابلة للتنفيذ لكل سيناريو
  </Card>

  <Card title="تتبع الطلبات" icon="fingerprint">
    `requestId` فريد لكل طلب يُتيح تصحيح الأخطاء والدعم بسهولة
  </Card>

  <Card title="أمان الأنواع" icon="lock">
    التحقق الكامل من المخطط يمنع الطلبات غير الصالحة ويضمن سلامة البيانات
  </Card>

  <Card title="اختبار Sandbox" icon="flask">
    اختبر جميع الميزات دون التأثير على رصيدك باستخدام وضع sandbox
  </Card>

  <Card title="توثيق تفاعلي" icon="book-open">
    جرّب استدعاءات API مباشرة في التوثيق مع playground المدمج
  </Card>
</CardGroup>

## التسعير ونموذج الأعمال

### بسيط وحسب الاستخدام

* **بدون رسوم تكامل** — ابدأ التطوير مجاناً
* **بدون اشتراكات شهرية** — ادفع فقط ما تستخدمه
* **بدون رسوم خفية** — ادفع فقط للمعاملات الناجحة
* **استرداد تلقائي** — المعاملات الفاشلة تُسترد فوراً

### كيف يعمل نظام الفوترة

1. **رصيد مدفوع مسبقاً**: حافظ على رصيد في حساب OneClickDz الخاص بك
2. **خصم تلقائي**: المعاملات الناجحة تُخصم من رصيدك
3. **تسعير شفاف**: جميع الأسعار بالدينار الجزائري (DZD)

### خصومات الأعمال

نقدم **أفضل الخصومات للشركات** التي تريد إعادة بيع خدماتنا للعملاء النهائيين. هيكل أسعارنا التنافسي مصمم لمساعدتك في بناء أعمال مربحة لخدمات الاتصالات.

<Card title="استفسر عن أسعار الأعمال" icon="handshake" href="/ar/contact">
  تواصل معنا لمناقشة خصومات الحجم وشراكات الأعمال
</Card>

## البدء

هل أنت مستعد للتكامل؟ اتبع هذه الخطوات البسيطة:

<Steps>
  <Step title="إنشاء حساب">
    سجّل على [enterprise.oneclickdz.com](https://enterprise.oneclickdz.com) للوصول إلى لوحة التحكم
  </Step>

  <Step title="إنشاء مفتاح API">
    فعّل وصول API في [الإعدادات](https://enterprise.oneclickdz.com/api-keys) وأنشئ مفاتيحك (sandbox + production)
  </Step>

  <Step title="الاختبار في Sandbox">
    استخدم وضع sandbox لاختبار جميع الميزات دون التأثير على رصيدك
  </Step>

  <Step title="الانتقال للإنتاج">
    انتقل إلى مفتاح الإنتاج عندما تكون مستعداً لمعالجة معاملات حقيقية
  </Step>
</Steps>

[ابدأ مع دليل البدء السريع ←](/ar/quickstart)

## تنسيق استجابة API

جميع endpoints الإصدار v3 تُرجع استجابات متسقة وقابلة للتنبؤ:

<CodeGroup>
  ```json استجابة النجاح theme={null}
  {
    "success": true,
    "data": {
      "balance": 50000
    },
    "meta": {
      "timestamp": "2025-10-29T00:00:00.000Z"
    },
    "requestId": "req_1234567890_abc123"
  }
  ```

  ```json استجابة الخطأ theme={null}
  {
    "success": false,
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Your balance is insufficient for this operation",
      "details": {
        "required": 1000,
        "available": 500
      }
    },
    "requestId": "req_1234567890_abc123"
  }
  ```
</CodeGroup>

[اعرف المزيد عن تنسيق الاستجابة ←](/ar/api-reference/response-format)

## حالات الاستخدام

<AccordionGroup>
  <Accordion icon="store" title="منصات التجارة الإلكترونية">
    ادمج خدمات الاتصالات في متجرك الإلكتروني. دع العملاء يشترون شحن الهاتف وإعادة شحن الإنترنت وبطاقات الهدايا مع منتجاتك.
  </Accordion>

  <Accordion icon="mobile-screen" title="تطبيقات الجوال">
    ابنِ تطبيقات شحن الهاتف لنظامي iOS وAndroid. قدّم شحن متعدد الشبكات مع تتبع في الوقت الفعلي وتوصيل فوري.
  </Accordion>

  <Accordion icon="building" title="أنظمة نقاط البيع">
    أضف خدمات رقمية إلى نقطة البيع. بِع رصيد الهاتف وبطاقات الإنترنت وبطاقات الهدايا في مواقع البيع بالتجزئة.
  </Accordion>

  <Accordion icon="users" title="التسويق متعدد المستويات">
    أنشئ شبكات إعادة البيع مع أنظمة العمولة. تتبع المعاملات وأدِر الأرصدة ووزِّع الأرباح تلقائياً.
  </Accordion>

  <Accordion icon="chart-line" title="الخدمات المالية">
    ادمج خدمات الاتصالات في تطبيقات البنوك ومنصات الدفع والمحافظ الرقمية لحلول مالية شاملة.
  </Accordion>

  <Accordion icon="headset" title="خدمة العملاء">
    ابنِ أدوات دعم لفرق الـ helpdesk لمساعدة العملاء بسرعة في الشحن وإعادة الشحن أثناء مكالمات الدعم.
  </Accordion>
</AccordionGroup>

## موارد المطورين

<CardGroup cols={3}>
  <Card title="مرجع API" icon="code" href="/ar/api-reference/response-format">
    توثيق كامل للـ endpoints
  </Card>

  <Card title="المصادقة" icon="key" href="/ar/authentication">
    أمّن وصولك إلى API
  </Card>

  <Card title="معالجة الأخطاء" icon="triangle-exclamation" href="/ar/api-reference/error-handling">
    تعامل مع الأخطاء كالمحترفين
  </Card>

  <Card title="استراتيجيات الاستطلاع" icon="rotate" href="/ar/polling-strategies">
    حسِّن فحص الحالة
  </Card>

  <Card title="Webhooks" icon="webhook" href="/ar/webhooks">
    إشعارات في الوقت الفعلي
  </Card>

  <Card title="أفضل الممارسات" icon="lightbulb" href="/ar/security-best-practices">
    أنماط جاهزة للإنتاج
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="دعم البريد الإلكتروني" icon="envelope" href="mailto:support@oneclickdz.com">
    تواصل مع فريق الدعم على [support@oneclickdz.com](mailto:support@oneclickdz.com)
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/oneclickdz">
    تصفح أمثلة الكود والـ SDKs
  </Card>
</CardGroup>

***

<Note>
  **هل أنت مستعد للبدء؟** توجّه إلى [دليل البدء السريع](/ar/quickstart) لإرسال أول شحنة في أقل من 5 دقائق.
</Note>