مفتاح 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 |
مفتاح API وسر التوقيع قيمتان مختلفتان. يصادق مفتاح API على طلباتك إلى Didit؛ ويتيح لك سر التوقيع التحقق من أن webhook جاء فعلًا من Didit. استخدام إحداهما بدل الأخرى يعطي 401 أو عدم تطابق في التوقيع.
#هل يمكنني رؤية سر توقيع webhook مجددًا؟
نعم. افتح المطورون ← Webhooks، وافتح نقطة النهاية واضغط إظهار. أكّد هويتك، فيظهر السر لمدة تصل إلى 60 ثانية. إذا كان إظهار معطّلًا لديك، فاطلب من زميل لديه صلاحية، أو تواصل مع الدعم. إذا أردت سرًا جديدًا، فدوّره بدلًا من ذلك: يستمر القديم بالعمل 24 ساعة. المزيد في الحصول على نتائج التحقق عبر webhooks.
#تحقق من إعدادك
- طابق البيئة
اختر التطبيق وبيئة Live أو Sandbox في الكونسول أولًا، ثم انسخ المفتاح ومعرّف سير العمل وأنشئ نقطة نهاية webhook هناك. مفتاح sandbox مع معرّف سير عمل live سبب شائع لـ 401 أو 403.
- ضع القيم في إعدادات خادمك
خزّنها كأسرار على جانب الخادم. لا تضع مفتاح API أو سر التوقيع أبدًا في كود الواجهة الأمامية أو مستودع عام أو تطبيق جوال.
- أنشئ جلسة
استدعِ نقطة نهاية إنشاء الجلسة على
https://verification.didit.meبمفتاحك ومعرّف سير العمل. يعني 401 أن المفتاح خاطئ أو منتهٍ أو ملغى؛ وغالبًا يعني 403 على سير عمل أن المفتاح ينتمي إلى تطبيق مختلف. انظر أخطاء API. - أرسل حدثًا تجريبيًا
في المطورون ← Webhooks، افتح نقطة النهاية واضغط إرسال حدث تجريبي. يجب أن يتحقق خادمك من التوقيع بسر التوقيع ويرد بـ 2xx. إذا لم يصل شيء، فانظر عندما لا يصل webhook.
#ذو صلة
- إدارة مفاتيح API
- الحصول على نتائج التحقق عبر webhooks
- بناء سير عمل تحقق
- مصادقة API على docs.didit.me
ما زلت عالقًا؟ تحدث إلى إنسان.
أرفق معرّف مؤسستك ومعرّف الجلسة التي تسأل عنها.