المصادقة
يُصادَق على كل طلب إلى واجهة CrispHive API بمفتاح API سرّي يُرسَل كرمز حامل (bearer token) في ترويسة Authorization. أنشئ المفاتيح من لوحة التحكم ضمن الإعدادات → المطوّرون — تُعرض قيمة المفتاح مرة واحدة فقط عند الإنشاء، فانسخها فورًا.
curl "https://api.crisphive.com/v1/customers" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"
بادئات المفاتيح تحدّد البيئة
تحدّد بادئة المفتاح بيئة البيانات: مفاتيح chsk_live_ تقرأ بيانات الإنتاج (الحيّة) وتكتب فيها، ومفاتيح chsk_test_ تستهدف بيئة الاختبار المعزولة. المفاتيح لا تنتهي صلاحيتها — بدّلها من لوحة التحكم عند الحاجة.
النطاقات
تمنح مفاتيح API حاليًا صلاحية وصول كاملة. الأذونات المحدودة بالنطاقات مدرجة في خارطة الطريق؛ وعند إطلاقها، سيظل المفتاح الذي لا يحمل نطاقات صريحة يعمل بصلاحية كاملة.