تتطلب جميع طلبات BuzzBip API مصادقة. ضمّن مفتاح API كرمز Bearer في رأس Authorization لكل طلب.
إنشاء مفتاح API
- سجّل الدخول إلى مساحة عمل BuzzBip على app.buzzbip.com
- انتقل إلى Settings → Developer → API Keys
- انقر Create API Key وأعطه اسماً وصفياً
- انسخ المفتاح فوراً — يُعرض مرة واحدة فقط
- خزّن المفتاح بأمان في بيئة الخادم أو مدير الأسرار
رأس Authorization
http
Authorization: Bearer YOUR_API_KEYلا تضمّن مفاتيح API في نظام التحكم بالإصدارات ولا تعرّضها في كود المتصفح. تعامل مع المفاتيح ككلمات مرور.
تدوير المفاتيح
دوّر المفاتيح دورياً أو فوراً عند الاشتباه بتسريب. أنشئ مفتاحاً جديداً، حدّث التكامل، تحقق من عمله، ثم ألغِ المفتاح القديم من صفحة Developer settings.
طلبات غير مصرّح بها
الطلبات بدون رمز صالح تُرجع 401 Unauthorized. الطلبات بمفتاح منتهٍ أو ملغى تُرجع 403 Forbidden. راجع HTTP Response Codes للقائمة الكاملة.