البدء السريع

تبني بـ Node.js أو PHP؟ استخدم حزمة تطوير رسمية بدلاً من ذلك — فهي تتولى المصادقة وإعادة المحاولة وأنواع الأخطاء نيابةً عنك.

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

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

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

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

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

curl https://api.nateq.io/api/v1/conversations \
  -H "Authorization: Bearer tg_live_your_key_here"

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);

import requests

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

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

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

{
  "success": true,
  "data": [ /* ... */ ],
  "meta": { "total": 42 }
}

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

{
  "success": false,
  "error": { "code": "INSUFFICIENT_SCOPE", "message": "API key does not have the required scope" }
}

هذا كل شيء — لقد تمت مصادقتك. توجّه إلى مرجع الـ API لاستكشاف كل نقطة نهاية عبر وحدة تحكم مباشرة.

ابدأ من هنا

حزم التطوير

المنصة

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

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

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

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

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

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

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

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

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