> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nateq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# البدء السريع

> قم بأول طلب مصادق عليه في أقل من خمس دقائق.

## 1. أنشئ مفتاح API

في لوحة تحكم Nateq الخاصة بك، افتح **الإعدادات → المطوّرون → مفاتيح API**
وأنشئ مفتاحاً. اختر **النطاقات** التي يحتاجها (على سبيل المثال
`conversations:read`). سترى المفتاح **مرة واحدة فقط** — انسخه إلى مكان آمن.

* مفاتيح الإنتاج تبدأ بـ `tg_live_`
* مفاتيح بيئة الاختبار تبدأ بـ `tg_test_`

## 2. قم بإرسال طلب

قم بالمصادقة عبر تمرير المفتاح كرمز Bearer في ترويسة `Authorization`.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.nateq.io/api/v1/conversations \
    -H "Authorization: Bearer tg_live_your_key_here"
  ```

  ```js Node theme={null}
  const res = await fetch("https://api.nateq.io/api/v1/conversations", {
    headers: { Authorization: "Bearer tg_live_your_key_here" },
  });
  const body = await res.json();
  console.log(body.data);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.nateq.io/api/v1/conversations",
      headers={"Authorization": "Bearer tg_live_your_key_here"},
  )
  print(res.json()["data"])
  ```
</CodeGroup>

## 3. اقرأ الاستجابة

تتبع كل استجابة الغلاف نفسه:

```json theme={null}
{
  "success": true,
  "data": [ /* ... */ ],
  "meta": { "total": 42 }
}
```

عند الفشل، تكون قيمة `success` هي `false` ويحمل `error` رمز `code` قابل للقراءة آلياً:

```json theme={null}
{
  "success": false,
  "error": { "code": "INSUFFICIENT_SCOPE", "message": "API key does not have the required scope" }
}
```

<Check>
  هذا كل شيء — لقد تمت مصادقتك. توجّه إلى [مرجع الـ API](/api-reference)
  لاستكشاف كل نقطة نهاية عبر وحدة تحكم مباشرة.
</Check>