المصادقة

كل طلب إلى الواجهة يُصادَق عليه بـمفتاح واجهة برمجة لمساحة العمل — وهو سرّ يخصّ مساحة عملك، يُنشأ ويُبطَل من التطبيق.

أنشئ مفتاحًا

1. في تطبيق الويب، افتح الإعدادات ← المطوّرون ← مفاتيح الواجهة.
2. اختر إنشاء مفتاح، وامنحه اسمًا يوضّح أين سيُستخدَم («تكامل Salesforce»، «روبوت الاستقبال»)، وتاريخ انتهاء اختياريًا.
3. انسخ المفتاح فورًا. فهو يبدأ بـisk_live_ ويُعرَض مرة واحدة فقط — إذ تخزّن إنستاسبيس بصمة تجزئة له لا المفتاح نفسه. وإن فقدته، فأبطِله وأنشئ غيره.

استخدم المفتاح

أرسله كرمز Bearer مع كل طلب:

curl https://api.instaspace.ai/api/v1/esign/templates \
  -H "Authorization: Bearer isk_live_..."

كيف يُفحَص الوصول

المفتاح مرتبط بمساحة العمل وبالعضو الذي أنشأه. وفي كل طلب، تعيد إنستاسبيس التحقّق من أن:

• المفتاح لم يُبطَل ولم تنتهِ صلاحيته،
• ومنشئه ما زال عضوًا في مساحة العمل،
• وخطة مساحة العمل ما زالت تشمل التوقيع الإلكتروني.

فينتهي الوصول لحظة إبطال المفتاح، أو مغادرة منشئه مساحة العمل، أو تخفيض الخطة — لا عند دورة تدوير لاحقة. ولكل حالة من الثلاث رمز 403 خاص بها: key_creator_left_organization وplan_missing_feature و(للحصة الشهرية) limit_reached. وتُنسَب طلبات التوقيع المنشأة عبر الواجهة إلى منشئ المفتاح، ويظهر نشاط الواجهة (مثل تنزيل مستند موقّع) في سجلّ تدقيق مساحة العمل بهوية المفتاح.