أنواع الـ keys
| البادئة | البيئة | الحالة |
|---|---|---|
sk_sandbox_ | Sandbox — مكالمات حقيقيّة ضمن قيود الـ sandbox (نافذة التجربة + قفل الوجهة) | متاح الآن |
sk_live_ | Production — بلا قيود | قادم مع مسار الترقية إلى الإنتاج |
اليوم، كلّ حساب ضمن فئة الـ sandbox. أمّا مفاتيح الإنتاج فتصل مع مسار الترقية إلى الإنتاج (لم يُطلَق بعد).
الحصول على key
تُنشأ الـ API keys وتُدار في لوحة تحكّم Wave (لا عبر الـ API):- سجّل الدخول في wave.sa.
- افتح API Keys.
- انسخ الـ key عند الإنشاء — يُعرَض مرّة واحدة.
إرسال الـ key
يجب أن يتضمّن كلّ طلب الـAuthorization header. تُعيد الطلبات التي تخلو من key صالح 401 مع غلاف الخطأ القياسيّ.