# أين أجد مفتاح API ومعرّف سير العمل وسر webhook؟

Source: https://help.didit.me/ar/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

مفتاح API ضمن المطورون ← مفاتيح API؛ ومعرّف سير العمل في صفحة سير العمل؛ وسر توقيع webhook لكل نقطة نهاية ضمن المطورون ← Webhooks.

تحتاج إلى ثلاث قيم من الكونسول. يُنشأ **مفتاح API** ضمن **المطورون ← مفاتيح API**. يُنسخ **معرّف سير العمل** من صفحة **سير العمل**. ينتمي **سر توقيع webhook** إلى كل نقطة نهاية ضمن **المطورون ← Webhooks**، ويمكنك إظهاره مجددًا في أي وقت عبر **إظهار**. خذ القيم الثلاث من التطبيق نفسه والبيئة نفسها، Live أو Sandbox.

كثيرًا ما يسرد تطبيق بدء أو مشروع مولَّد بالذكاء الاصطناعي متغيرات بيئة مثل `DIDIT_API_KEY` و`DIDIT_WORKFLOW_ID` و`DIDIT_WEBHOOK_SECRET`. الأسماء تخص ذلك التطبيق: لا تضبطها Didit لك. يبيّن هذا الجدول مصدر كل قيمة.

## أين توجد كل قيمة

| القيمة | من أين تحصل عليها | ما يجب معرفته |
|---|---|---|
| **مفتاح API** | **المطورون ← مفاتيح API**، ثم **أنشئ مفتاحًا** (لكل تطبيق أيضًا مفتاح **أساسي**) | يظهر السر الكامل مرة واحدة، عند إنشاء المفتاح أو تدويره، فانسخه إلى مدير الأسرار لديك حينها. لتطبيق Live وتطبيق Sandbox مفتاحان مختلفان: مفتاح sandbox لا ينشئ أبدًا تحققًا حقيقيًا. أرسله في ترويسة `x-api-key`، من خادمك فقط |
| **معرّف سير العمل** | **التحقق من الهوية ← سير العمل**: افتح قائمة الصف واختر **نسخ معرّف سير العمل** (للوحة المعاينة الزر نفسه) | لكل سير عمل معرّف خاص في كل تطبيق. نسخة من سير العمل تحصل على معرّف جديد |
| **سر توقيع webhook** | **المطورون ← Webhooks**، افتح نقطة النهاية، ثم سر التوقيع الخاص بها واضغط **إظهار** | سر واحد لكل نقطة نهاية، وليس لكل تطبيق. يطلب الإظهار تأكيد هويتك، ثم يُخفى السر مجددًا خلال 60 ثانية. يمكنك إظهاره مجددًا متى احتجت |
| **عنوان API الأساسي** | ليس في الكونسول: تذكره docs.didit.me | يخدم `https://verification.didit.me` واجهة التحقق (الجلسات وسير العمل والقوائم وwebhooks)، ويُصادَق عليه بترويسة `x-api-key`. انظر [مصادقة API](https://docs.didit.me/getting-started/api-authentication) |

> **Note:** مفتاح API وسر التوقيع قيمتان مختلفتان. يصادق مفتاح API على طلباتك إلى Didit؛
> ويتيح لك سر التوقيع التحقق من أن webhook جاء فعلًا من Didit. استخدام إحداهما
> بدل الأخرى يعطي 401 أو عدم تطابق في التوقيع.

## هل يمكنني رؤية سر توقيع webhook مجددًا؟

نعم. افتح **المطورون ← Webhooks**، وافتح نقطة النهاية واضغط **إظهار**. أكّد هويتك، فيظهر السر لمدة تصل إلى 60 ثانية. إذا كان **إظهار** معطّلًا لديك، فاطلب من زميل لديه صلاحية، أو [تواصل مع الدعم](https://help.didit.me/ar/getting-started/contacting-didit-support). إذا أردت سرًا جديدًا، فدوّره بدلًا من ذلك: يستمر القديم بالعمل 24 ساعة. المزيد في [الحصول على نتائج التحقق عبر webhooks](https://help.didit.me/ar/integration/webhooks-basics).

## تحقق من إعدادك

1. **طابق البيئة**

   اختر التطبيق وبيئة **Live** أو **Sandbox** في الكونسول أولًا، ثم انسخ المفتاح ومعرّف سير العمل وأنشئ نقطة نهاية webhook هناك. مفتاح sandbox مع معرّف سير عمل live سبب شائع لـ 401 أو 403.

2. **ضع القيم في إعدادات خادمك**

   خزّنها كأسرار على جانب الخادم. لا تضع مفتاح API أو سر التوقيع أبدًا في كود الواجهة الأمامية أو مستودع عام أو تطبيق جوال.

3. **أنشئ جلسة**

   استدعِ نقطة نهاية إنشاء الجلسة على `https://verification.didit.me` بمفتاحك ومعرّف سير العمل. يعني 401 أن المفتاح خاطئ أو منتهٍ أو ملغى؛ وغالبًا يعني 403 على سير عمل أن المفتاح ينتمي إلى تطبيق مختلف. انظر [أخطاء API](https://help.didit.me/ar/integration/api-errors).

4. **أرسل حدثًا تجريبيًا**

   في **المطورون ← Webhooks**، افتح نقطة النهاية واضغط **إرسال حدث تجريبي**. يجب أن يتحقق خادمك من التوقيع بسر التوقيع ويرد بـ 2xx. إذا لم يصل شيء، فانظر [عندما لا يصل webhook](https://help.didit.me/ar/integration/webhook-troubleshooting).

## ذو صلة

- [إدارة مفاتيح API](https://help.didit.me/ar/account-organization/api-keys)
- [الحصول على نتائج التحقق عبر webhooks](https://help.didit.me/ar/integration/webhooks-basics)
- [بناء سير عمل تحقق](https://help.didit.me/ar/workflows/build-a-verification-workflow)
- [مصادقة API](https://docs.didit.me/getting-started/api-authentication) على docs.didit.me