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

# قائمة منتجات الإنترنت

> احصل على بطاقات إنترنت ADSL و 4G LTE المتاحة مع المخزون في الوقت الفعلي

<div dir="rtl">
  ## نظرة عامة

  يعيد هذا الـ endpoint قائمة بطاقات شحن الإنترنت المتاحة لخدمات ADSL و 4G LTE مع الأسعار في الوقت الفعلي وتوافر المخزون.

  ## معاملات الاستعلام

  <ParamField query="type" type="string" required>
    نوع خدمة الإنترنت: `ADSL` أو `4G`
  </ParamField>

  ## الاستجابة

  <ResponseField name="success" type="boolean" required>
    يشير إلى نجاح الطلب
  </ResponseField>

  <ResponseField name="data" type="object" required>
    <Expandable title="الخصائص">
      <ResponseField name="products" type="array" required>
        مصفوفة من كائنات المنتجات

        <Expandable title="كائن المنتج">
          <ResponseField name="cost" type="number">
            تكلفة هذه البطاقة بالدينار الجزائري
          </ResponseField>

          <ResponseField name="value" type="number">
            القيمة الاسمية للبطاقة بالدينار الجزائري
          </ResponseField>

          <ResponseField name="available" type="boolean">
            توافر المخزون (true = متوفر)
          </ResponseField>
        </Expandable>
      </ResponseField>

      <ResponseField name="type" type="string" required>
        نوع الخدمة: `ADSL` أو `4G`
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="meta" type="object" required>
    <Expandable title="الخصائص">
      <ResponseField name="timestamp" type="string">
        طابع زمني للاستجابة بتنسيق ISO 8601
      </ResponseField>
    </Expandable>
  </ResponseField>

  ## أمثلة

  <CodeGroup>
    ```bash ADSL Products theme={null}
    curl "https://api.oneclickdz.com/v3/internet/products?type=ADSL" \
      -H "X-Access-Token: YOUR_API_KEY"
    ```

    ```bash 4G Products theme={null}
    curl "https://api.oneclickdz.com/v3/internet/products?type=4G" \
      -H "X-Access-Token: YOUR_API_KEY"
    ```

    ```javascript Node.js theme={null}
    const type = "ADSL"; // or '4G'
    const response = await fetch(
      `https://api.oneclickdz.com/v3/internet/products?type=${type}`,
      { headers: { "X-Access-Token": "YOUR_API_KEY" } }
    );
    const { data } = await response.json();
    ```

    ```python Python theme={null}
    response = requests.get(
        'https://api.oneclickdz.com/v3/internet/products',
        headers={'X-Access-Token': 'YOUR_API_KEY'},
        params={'type': 'ADSL'}
    )
    products = response.json()['data']['products']
    ```

    ```php PHP theme={null}
    <?php
    $type = 'ADSL'; // or '4G'
    $ch = curl_init("https://api.oneclickdz.com/v3/internet/products?type={$type}");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: YOUR_API_KEY']);
    $response = curl_exec($ch);
    $data = json_decode($response, true);
    $products = $data['data']['products'];
    ?>
    ```
  </CodeGroup>

  ### مثال استجابة منتجات ADSL

  ```json theme={null}
  {
    "success": true,
    "data": {
      "products": [
        {
          "cost": 1900,
          "value": 2000,
          "available": false
        },
        {
          "cost": 2850,
          "value": 3000,
          "available": true
        },
        {
          "cost": 475,
          "value": 500,
          "available": true
        },
        {
          "cost": 950,
          "value": 1000,
          "available": true
        }
      ],
      "type": "ADSL"
    },
    "meta": {
      "timestamp": "2025-10-29T00:36:50.059Z"
    }
  }
  ```

  ## ملاحظات مهمة

  <Warning>
    **احذف `cost` قبل العرض على المستخدمين النهائيين.** طبّق هامش الربح الخاص بك للتسعير.
  </Warning>

  <Note>
    تحقق من `available: true` قبل السماح للمستخدمين بالطلب. مستويات المخزون آنية.
  </Note>

  ## تنسيقات أرقام الهاتف

  ### أرقام ADSL

  * الصيغة: `0[0-9]{8}`
  * أمثلة: `036362608`، `031417237`
  * أرقام الخطوط الثابتة (الأرضية)

  ### أرقام 4G

  * الصيغة: `213[0-9]{9}`
  * أمثلة: `213472731602`، `213665983439`
  * أرقام الجوال مع رمز الدولة

  [التحقق من الأرقام قبل الطلب ←](/ar/api-reference/internet/validate-number)

  ## أفضل الممارسات

  <CardGroup cols={2}>
    <Card title="تحقق من المخزون" icon="boxes-stacked">
      تحقق دائماً من `available: true` قبل العرض على المستخدمين
    </Card>

    <Card title="طبّق هامش الربح" icon="percent">
      الحساب: `sellPrice = cost * (1 + yourMargin)`
    </Card>

    <Card title="التخزين المؤقت" icon="clock">
      خزّن لمدة 5-10 دقائق لتقليل استدعاءات API
    </Card>

    <Card title="التحقق من الأرقام" icon="circle-check">
      استخدم endpoint التحقق قبل تقديم الطلبات
    </Card>
  </CardGroup>

  ## Endpoints ذات الصلة

  <CardGroup cols={2}>
    <Card title="التحقق من الرقم" icon="check" href="/ar/api-reference/internet/validate-number">
      التحقق من الهاتف قبل الطلب
    </Card>

    <Card title="إرسال شحن" icon="paper-plane" href="/ar/api-reference/internet/send-topup">
      شراء بطاقة إنترنت
    </Card>
  </CardGroup>
</div>