# رموز API | Procurize.AI

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

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

## نظرة عامة

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

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

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

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

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

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

![لوحة رموز API](/images/docs/api-tokens-panel.png)

> **الإذن المطلوب:** فقط المستخدمون الذين لديهم دور **مشرف** أو **مسؤول** يمكنهم الوصول إلى هذه اللوحة. للحصول على تعريفات تفصيلية للأدوار، راجع [نظرة عامة على الأذونات](/what-user-permissions-does-procurize-have/) .

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

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

3. انقر **"إنشاء"**.

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

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

![رمز API جديد](/images/docs/new-api-token.png)

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

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

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

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

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

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

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

### إلغاء رمز

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

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

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

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

### مثال طلب (cURL)

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

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

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

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

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

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

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

- [نظرة عامة على الأذونات](/what-user-permissions-does-procurize-have/) – تعريفات تفصيلية للأدوار
- [خطط التسعير](https://www.procurize.ai/pricing/) – أي الخطط تشمل الوصول إلى API
- [مرجع REST API](/rest-api-reference/) – توثيق مفصل للنقاط النهاية

{{<article-feedback>}}