رموز API | Procurize.AI#

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

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

نظرة عامة#

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

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

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

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

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

انتقل إلى لوحة التحكم → الإعدادات → علامة تبويب الرموز.
تظهر لوحة إدارة الرموز رموزك الشخصية المرتبطة بالمؤسسة الحالية.

لوحة رموز API

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

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

أدخل اسمًا لتحديد غرض الرمز.
اختر فترة انتهاء:
- شهر واحد
- ثلاثة أشهر
- سنة واحدة
- بدون انتهاء (صلاحية غير محدودة)
انقر “إنشاء”.

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

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

رمز API جديد

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

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

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

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

تعطيل / إعادة تفعيل رمز#

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

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

إلغاء رمز#

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

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

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

المعامل	القيمة
عنوان URL الأساسي	`https://api.procurize.com`
طريقة المصادقة	مفتاح API عبر الرأس
الرأس	`X-API-Key: <YOUR_API_TOKEN>`

مثال طلب (cURL)#

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

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

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

القاعدة	الشرح
أذونات الرمز	يمتلك الرمز نفس الأذونات تمامًا كما للمستخدم الذي أنشأه. إذا تغير دور المستخدم، تُحدَّث أذونات الرمز وفقًا لذلك.
ربط المؤسسة	ترتبط الرموز بالمؤسسة التي أنشأت الرمز. لا يمكن استخدام الرمز عبر مؤسسات متعددة.
رؤية الرمز	يتم إظهار قيمة الرمز مرة واحدة فقط. احفظها فورًا. تقوم Procurize.AI بتخزين التجزئة فقط.
الرموز المنتهية	تُعطل الرموز المنتهية تلقائيًا ولا يمكن استخدامها. أنشئ رمزًا جديدًا إذا لزم الأمر.

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

المشكلة	الحل
خطأ “مفتاح API غير صالح”	تأكد من نسخ الرمز بشكل صحيح (بدون مسافات إضافية). تحقق من أن الرمز لا يزال نشطًا وغير منتهي.
الرمز لا يعمل بعد تغيير الدور	يتم تحديث أذونات الرمز لتطابق دور المستخدم الحالي. إذا فقد المستخدم أذونات، يفقد الرمز أذوناته أيضًا.
فقدان الرمز	قم بإلغاء الرمز المفقود وأنشئ رمزًا جديدًا.
تحديد معدل الطلبات	تُطبق حدود معدل API بناءً على خطتك. راجع رؤوس `X-RateLimit-*` في الاستجابة.