الانتقال إلى المحتوى الرئيسي

​
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"

​
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 لاستكشاف كل نقطة نهاية عبر وحدة تحكم مباشرة.