بناء التطبيق
التطبيق الخارجي (External)
الإعداد
عند إنشاء تطبيق External تُدخل:
webhook_url: عنوان HTTPS يستقبل أحداث المستأجر.webhook_events: قائمة أحداث الاشتراك (مثلeducation.students.created).redirect_urls: عناوين OAuth callbacks لتدفّق التثبيت.
Installation Token
عندما يُثبِّت مستأجر تطبيقك، يُصدَر installation token فريد لتلك الـ (مستأجر، تطبيق). هذا الـ token هو ما تستخدمه في كل طلب API.
Authorization: Bearer <installation_token>
التوكن:
- يدوم بشكل دائم حتى يُلغى أو يُدوَّر.
- المستأجر يستطيع تدويره/إلغاءه من لوحة "تطبيقاتي" في أي وقت.
- يحمل النطاقات التي وافق عليها المستأجر — نطاق غير مُمنح = 403.
تدوير الـ Token
عند تدوير المستأجر للـ token، تستلم webhook event
partner.installation.token_rotated. الـ token الجديد فيه؛ احفظه فوراً.
الـ token القديم يبقى صالحاً لمدة 15 دقيقة (grace period) لتسهيل
الانتقال بدون انقطاع.