التطبيقات والمفاتيح

التطبيق هو منتج واحد في مؤسستك. لكل تطبيق مفتاح عام ومفتاح سري لكل بيئة؛ المفتاح السري هو ما يخاطب به خادمك الـ REST API.

01التطبيقات

أنشئ تطبيقاً لكل منتج تطرحه — تطبيق السائق وتطبيق العيادة لا يجوز أن يتشاركا المفاتيح أو الـ webhooks أو سجل المكالمات. كل تطبيق يحمل مفاتيح API خاصة به ومسارات webhook وبيانات إشعارات للرنين وسجل مكالمات مستقلاً.

أنشئ التطبيقات وأدِرها من لوحة التحكم ← التطبيقات. حذف التطبيق يلغي مفاتيحه فوراً وتفشل أي مكالمة جديدة بها.

02المفاتيح التجريبية والفعلية

لكل تطبيق زوج مفاتيح تجريبي وزوج فعلي. المفاتيح التجريبية (pk_test_… / sk_test_…) تنشئ مكالمات تتصرف تماماً كالفعلية — صوت حقيقي وwebhooks حقيقية — لكنها لا تُفوتر أبداً ولا تُحتسب من الباقة المجانية.

المفاتيح الفعلية (pk_live_… / sk_live_…) لا تعمل إلا بعد تفعيل الوضع الفعلي للتطبيق؛ قبل ذلك يردّ كل طلب بـ 403 Live mode is not enabled for this app.

03العام والسري

تجد المفتاحين في لوحة التحكم ← التطبيقات ← المفاتيح. المفتاح السري يُعرض مرة واحدة عند إنشائه أو تدويره ويُخزّن مشفّراً بعدها.

04توثيق الطلبات

أرسل المفتاح السري بوصفه bearer token في كل طلب. المفتاح يحدّد التطبيق والبيئة — لا يوجد معرّف حساب منفصل تمرّره.

05تدوير المفتاح

دوّر المفتاح السري من لوحة التحكم ← مفاتيح API ← تدوير المفتاح. المفتاح القديم يتوقف لحظة التأكيد، فانشر المفتاح الجديد على خوادمك أولاً ودوّر في وقت هادئ.

التدوير لا يغيّر المفتاح العام ولا المكالمات الجارية ولا رموز الانضمام الصادرة — الرموز يوقّعها صدى لا مفتاحك.

06إبقاء السري سرّاً

• خزّن المفاتيح في متغيرات البيئة (SADA_SECRET_KEY) لا في الكود.
• استخدم المفاتيح التجريبية في التطوير وCI؛ خوادم الإنتاج وحدها تحمل المفتاح الفعلي.
• أصدر رموز الانضمام على خادمك بعد التحقق من هوية المستخدم بنفسك — الرمز هو ما يصل التطبيق، لا المفتاح.
• لوحة التحكم تعرض آخر استخدام لكل مفتاح؛ «آخر استخدام» غير متوقع هو أول إشارة إلى تسرّب.