ابدأ مع واجهة لقاء البرمجية

استخدم واجهة لقاء البرمجية لقراءة الفعاليات وتسجيلات الضيوف وأعضاء المجتمعات من نظامك. الواجهة «للقراءة فقط» وتلتزم بصلاحياتك الحالية في الفعاليات والمجتمعات.

أنشئ مفتاح API

1. افتح إعدادات مفاتيح APIانتقل إلى الإعدادات ← مفاتيح API بعد تسجيل الدخول إلى لقاء.
2. سمِّ المفتاح واختر الصلاحياتاضغط «إنشاء مفتاح»، وأعطه «الاسم» الذي يسهل عليك تمييزه لاحقًا (مثل: مزامنة CRM)، ثم اختر من «الصلاحيات» ما يحتاجه تكاملك فقط: «قراءة الفعاليات» أو «قراءة الضيوف» أو «قراءة المجتمعات والأعضاء».
3. انسخ المفتاحيظهر المفتاح كاملًا مرة واحدة فقط تحت عنوان «انسخ مفتاحك الآن». انسخه واحفظه في متغير بيئة أو مخزن أسرار على الخادم قبل الضغط على «تم».

أرسل طلبك الأول

احفظ مفتاحك في متغير البيئة LIQA_API_KEY في الطرفية، ثم أرسل طلب GET /me للتأكد من أنه يعمل. جميع المسارات تقع تحت العنوان الأساسي https://liqa.io/api/public/v1.

curl "https://liqa.io/api/public/v1/me" \
  -H "Authorization: Bearer $LIQA_API_KEY"

توضح الاستجابة المفتاح المستخدم وصلاحياته (scopes) والحساب الذي ينتمي إليه:

{
  "data": {
    "key": {
      "id": "…",
      "name": "CRM sync",
      "scopes": ["events:read", "guests:read"]
    },
    "user": { "id": "…", "name": "…", "email": "…" }
  }
}

الخطوات التالية

• افتح مرجع API لاختيار المسار والاطّلاع على معاملاته وحقول الاستجابة.
• تأكد أن المفتاح يحمل الصلاحية المطلوبة: «قراءة الفعاليات» أو «قراءة الضيوف» أو «قراءة المجتمعات والأعضاء».
• احتفظ بالمفتاح في مخزن أسرار الخادم أو متغيرات البيئة عند ربط تطبيقك.