إنستاسبيس
واجهة برمجة التطبيقات

المصادقة

أنشئ مفتاح واجهة برمجة لمساحة العمل وصادِق به على طلباتك.

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

أنشئ مفتاحًا

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

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

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

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

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

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

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

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

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

في هذه الصفحة