رموز API | Procurize.AI#

إنشاء وإدارة واستخدام رموز API للوصول البرمجي الآمن إلى مساحة عمل Procurize.AI الخاصة بك.

ينطبق على: لوحة تحكم Procurize.AI → الإعدادات → الرموز
متاح في: خطط الأعمال والمؤسسات
الدور المطلوب: مدير الأمان، محرر، مسؤول أو مشرف

نظرة عامة#

تمكّن رموز API من الوصول البرمجي الآمن إلى منصة Procurize.AI. يمكنك استخدام الرموز لدمج Procurize.AI مع أنظمتك الداخلية، أتمتة سير العمل، أو بناء تطبيقات مخصصة فوق المنصة.

الخصائص الرئيسية:

• ترث الرموز جميع الأذونات للمستخدم الذي أنشأها
• الرموز مقيدة بالمؤسسة – لا حاجة لتحديد org في طلبات API
• يمكن إنشاء عدد غير محدود من الرموز
• يمكن للرموز أن تكون لها تواريخ انتهاء أو تُضبط لتكون غير منتهية
• يمكن إلغاء تنشيط الرموز ثم إعادة تنشيطها حسب الحاجة

🔒 ملاحظة أمان: لا تقوم Procurize.AI بتخزين قيمة الرمز – بل تخزن فقط التجزئة الخاصة به. يجب عليك نسخ الرمز وحفظه فور إنشائه. لن يتم عرضه مرة أخرى.

الوصول إلى لوحة إدارة الرموز#

1. انتقل إلى صفحة لوحة التحكم → رموز API.
2. تعرض لوحة إدارة الرموز رموزك الشخصية المرتبطة بالمؤسسة الحالية.

الإذن المطلوب: يمكن فقط للمستخدمين الذين يملكون أدوار مدير الأمان، محرر، مسؤول أو مشرف الوصول إلى هذه اللوحة. للحصول على تعريفات مفصلة للأدوار، راجع نظرة عامة على الأذونات .

إنشاء رمز جديد#

1. أدخل اسمًا لتحديد هدف الرمز.

2. اختر فترة الانتهاء:

   • شهر واحد
   • 3 أشهر
   • سنة واحدة
   • بدون انتهاء (صلاحية غير محدودة)

3. اضغط “إنشاء”.

مهم – انسخ الرمز فورًا#

بعد الإنشاء، تُعرض قيمة الرمز مرة واحدة – انسخها واحفظها بأمان (مثلاً في مدير كلمات المرور أو متغيّر بيئي).

⚠️ لن تتمكن من مشاهدة قيمة الرمز مرة أخرى. تقوم Procurize.AI بتخزين تجزئة آمنة فقط للتحقق. إذا فقدت الرمز، يجب إلغاؤه وإنشاء رمز جديد.

إدارة الرموز الموجودة#

تعرض لوحة الرموز قائمة بجميع الرموز التي تم إنشاؤها مع:

• الاسم
• اللاحقة
• تاريخ الإنشاء
• تاريخ الانتهاء (أو “-”)
• الحالة: نشط أو غير نشط

إلغاء تنشيط / إعادة تنشيط رمز#

• إلغاء التنشيط – يعطل الرمز مؤقتًا. يمكنك إعادة تنشيطه لاحقًا عند الحاجة.
• إعادة التنشيط – يعيد الرمز غير النشط إلى حالة نشطة.

💡 إلغاء التنشيط مفيد لتعليق التكاملات مؤقتًا دون حذف الرمز.

إلغاء رمز#

• إلغاء – يحذف الرمز نهائيًا. لا يمكن التراجع عن هذا الإجراء.
• إذا فقدت رمزًا، ألغِه فورًا وأنشئ رمزًا جديدًا.

استخدام رمز API#

عنوان URL الأساسي & المصادقة#

مثال طلب (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 لا حاجة إلى معرف المؤسسة – الرمز مرتبط بمؤسستك، لذا يحدد السياق تلقائيًا.

قواعد الأمان والاستخدام المهمة#

استكشاف الأخطاء وإصلاحها#

مواضيع ذات صلة#

• نظرة عامة على الأذونات – تعريفات مفصلة للأدوار
• خطط التسعير – أي الخطط تشمل الوصول إلى API
• مرجع REST API – توثيق مفصل للنقاط النهائية