المصادقة ومفاتيح API

كل طلب يحمل مفتاح API في ترويسة Authorization، وكل مفتاح محدود بصلاحيات.

المفتاح مرتبط بمساحة عمل واحدة، ويُرفض أي طلب يذكر مساحة عمل أخرى. يُحفظ المفتاح لدينا مُجزّأً (hash) فقط، ويمكن إلغاؤه أو تحديد تاريخ انتهاء له.

• events:write — إرسال الأحداث والتحويلات
• contacts:read — قراءة جهات الاتصال
• segments:read — قراءة الشرائح
• campaigns:read — قراءة الحملات
• events:read — قراءة الأحداث
• conversions:read — قراءة التحويلات

Authorization: Bearer <your API key>

الرموز: 401 عند غياب المفتاح أو إلغائه أو انتهائه، و403 عندما لا يملك المفتاح الصلاحية المطلوبة أو يذكر الطلب مساحة عمل أخرى، و429 عند تجاوز حد المعدل مع ترويسة Retry-After.