المصادقة ومفاتيح API
كل طلب للـ API العام لازم يكون فيه مفتاح مساحة العمل في هيدر Authorization:
http
Authorization: Bearer otp_live_xxxxxxxxxxxxxxxxxxxxxxxxإنشاء المفاتيح
- لوحة التحكم ← مفاتيح API ← إنشاء مفتاح (دور developer أو أعلى).
- المفتاح الكامل بيظهر مرة واحدة. Otpera بيحتفظ بـ hash بس، فلو ضاع اعمل مفتاح جديد وألغِ القديم.
- سمّي المفتاح باسم المكان اللي هيستخدمه (مثلًا
production-backendأوshopify-main-store).
الصلاحيات
| الصلاحية | بتسمح بـ |
|---|---|
verifications:write | إنشاء وتحقق وإعادة إرسال وقراءة رموز OTP |
orders:write | إنشاء الطلبات وإعادة إرسال التأكيد (API الطلبات) وWebhook Shopify |
orders:read | قراءة الطلبات والمنتجات وسجل الحالات والرسائل |
خلّي المفاتيح سرية
على السيرفر بس
عمرك ما تحط مفتاح API في JavaScript المتصفح أو تطبيق موبايل أو مستودع عام أو متغير VITE_* / NEXT_PUBLIC_*. أي حد معاه المفتاح يقدر يبعت رسايل من رقمك ويصرف رصيدك.
مفتاح ناقص أو غلط أو منتهي أو ملغي بيرجّع 401، ومفتاح من غير الصلاحية المطلوبة بيرجّع 403.