إنشاء مفتاح API

لكل موقع تتبع مفاتيح API خاصة به. والمفتاح مرتبط بموقع واحد — لا يمكن استخدامه إلا لإرسال أحداث site_id ذلك الموقع.

الخطوات

يظهر مفتاح API الأصلي مرة واحدة فقط. وإذا أغلقت النافذة دون نسخه، فسيلزمك إبطاله وإنشاء مفتاح جديد.

احفظ المفتاح في متغير بيئة على الخادم لديك. ولا تكتبه مباشرة في الكود المصدري أبدًا.

# .env
SCANOVA_API_KEY=your_key_here

// Node.js
const apiKey = process.env.SCANOVA_API_KEY;

# Python
import os
api_key = os.environ['SCANOVA_API_KEY']

يمكن أن يكون للموقع مفتاحا API نشطان في الوقت نفسه. فاسحب المفتاح القديم عند إنشاء مفتاح جديد
أبطل المفاتيح غير المستخدمة أو المكشوفة فورًا من تبويب تتبع عبر API
بحد أقصى مفتاحين، يشغل الفصل بين بيئتَي الإنتاج والاختبار كلا المكانين — فخطط للتبديل على هذا الأساس

أرسله كترويسة مع كل طلب حدث خادم:

POST /server-events HTTP/1.1
Host: track.scanova.io
Content-Type: application/json
X-API-Key: YOUR_API_KEY

يجب أن يطابق المفتاح قيمة site_id التي ترسلها في جسم الطلب. وعند عدم التطابق يعود الرد 403.