> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # قائمة وجهات webhook عبر API > استرجع كل وجهات webhook في Didit مع إصدار webhook والأحداث المشتركة ومقاييس التسليم لآخر 30 يومًا وحالة التشغيل. الدفع لكل استدعاء. موجّه API لعرض وجهات webhook نسخ الموجّه إلى الحافظة \

\`List every webhook destination configured for my Didit application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/webhook/destinations/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Get every webhook destination (URL, version, subscribed events, delivery health) for my application. Use this to build a back-office "Webhooks" screen or to audit which destinations are receiving which events.

Behavior:
\- Returns a JSON array (not paginated) of destinations ordered by created_at.
\- The list never includes the signing secret (secret_shared_key) and has no summary object. Each item carries secret_last4, the last four characters of the secret, so you can tell secrets apart. Read the full secret from GET /v3/webhook/destinations/{destination_uuid}/.
\- Each item carries flat delivery metrics for the last 30 days (metrics_window_days is always 30): deliveries_count, failed_deliveries_count, average_response_time_ms and error_rate_percentage. last_delivery_at is the most recent attempt.
\- daily_points has 30 entries, oldest first, one per UTC day: { date, total_deliveries, failed_deliveries }. Days without deliveries carry zeros.
\- health_status is "failing" when 3 or more consecutive events failed their first delivery attempt since the destination last answered successfully (failing_streak counts them, failing_since is when the first one failed), "degraded" when an attempt failed in the last 24 hours and no later attempt has delivered that event, and "healthy" otherwise. It does not reflect enabled.
\- last_success_at is when the destination last answered under HTTP 400 in the last 30 days (null if it has not).
\- created_by_email and created_by_name name the Business Console member who created the destination; both are null for a destination created with an API key.
\- environment is "live" or "sandbox", from the application.

Example call:
curl -X GET "https://verification.didit.me/v3/webhook/destinations/" \
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
\- uuid — destination id; use as {destination_uuid} in subsequent calls.
\- url, label, enabled — basic config.
\- webhook_version — payload schema version ("v1", "v2", or "v3"; v3 is current).
\- subscribed_events — list of event names this destination receives. There is no wildcard.
\- health_status: the signal to alert on. failing_streak and failing_since tell you how long a destination has been failing.

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope.
\- 429 — rate limited; back off and retry.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\
الصق في ## حالة تشغيل الوجهةيلخّص `health_status` كيف استجابت الوجهة لعمليات التسليم الخاصة بها.| القيمة | المعنى | | - | - | | `failing` | فشلت 3 أحداث متتالية أو أكثر في محاولة التسليم الأولى منذ آخر استجابة ناجحة من الوجهة. يحسب `failing_streak` هذه الأحداث، و`failing_since` هو وقت فشل أولها. | | `degraded` | الوجهة ليست في حالة فشل، لكن فشلت محاولة تسليم خلال آخر 24 ساعة، ولم تنجح أي محاولة لاحقة في تسليم ذلك الحدث. تؤدي إعادة المحاولة أو إعادة الإرسال الذي ينجح في تسليمه إلى مسح هذه الحالة. | | `healthy` | لا تنطبق أي من الحالتين السابقتين. |تُعد المحاولة فاشلة إذا ردّت الوجهة برمز HTTP 400 أو أعلى، أو إذا لم ترد على الإطلاق (انتهاء المهلة، أو رفض الاتصال، أو حظر العنوان). لا تُضاف إعادة المحاولات إلى `failing_streak`، وأي محاولة ناجحة، بما في ذلك إعادة المحاولة أو إعادة الإرسال، تنهي السلسلة. `health_status` مستقل عن `enabled`.تغطي مقاييس التسليم و`daily_points` آخر 30 يومًا (`metrics_window_days`). يحتوي `daily_points` دائمًا على 30 عنصرًا، واحدًا لكل يوم UTC، مرتبةً من الأقدم إلى الأحدث.## ذات صلة- [الحصول على وجهة webhook](https://docs.didit.me/ar/management-api/webhook/get-destination.md): قراءة وجهة واحدة مع سر التوقيع وملخص التسليم. - [دليل webhook](https://docs.didit.me/ar/integration/webhooks.md): التحقق من التوقيع وإعادة المحاولات والـ payload. ## OpenAPI ````yaml ar/openapi-25.json GET /v3/webhook/destinations/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/webhook/destinations/: get: tags: - Webhook summary: عرض قائمة بوجهات webhook description: >- سرد جميع وجهات webhook (مصفوفة غير مقسمة إلى صفحات، الأقدم أولاً). يتضمن كل عنصر إعدادات الوجهة، ومقاييس التسليم الخاصة بها لآخر 30 يوماً (`metrics_window_days`) مع إدخال `daily_points` واحد لكل يوم، وحالة التشغيل الخاصة بها (`health_status` و`failing_streak` و`failing_since` و`last_success_at`). لا تحتوي القائمة على كائن `summary` ولا تتضمن أبداً سر التوقيع: يُظهر كل عنصر `secret_last4` فقط. قم بجلب وجهة واحدة (`GET /v3/webhook/destinations/{destination_uuid}/`) لقراءة `secret_shared_key`. operationId: list_webhook_destinations responses: '200': description: عرض وجهات webhook (بدون تقسيم إلى صفحات، الأقدم أولاً). content: application/json: schema: type: array items: type: object properties: uuid: type: string format: uuid description: >- معرّف الوجهة الثابت؛ يُستخدم كـ `{destination_uuid}` للتحديث/الحذف. label: type: string description: اسم سهل القراءة معروض في Console. url: type: string format: uri description: >- رابط الوجهة الذي يتلقى طلبات `POST` مع payload الخاص بـ webhook. enabled: type: boolean description: >- عندما تكون القيمة `false`، تتخطى Didit التسليم إلى هذه الوجهة دون إشعار. webhook_version: type: string enum: - v1 - v2 - v3 description: >- إصدار مخطط payload المرسل إلى هذه الوجهة. الإصدار `v3` هو التنسيق الحالي/الموصى به. subscribed_events: $ref: '#/components/schemas/WebhookSubscribedEvents' subscribed_events_count: type: integer description: >- طول `subscribed_events` المخزن مؤقتاً، وهو مفيد لعرض واجهة المستخدم. deliveries_count: type: integer description: >- محاولات التسليم (بما في ذلك عمليات إعادة المحاولة) التي تمت إلى هذه الوجهة في آخر 30 يوماً. failed_deliveries_count: type: integer description: >- محاولات التسليم خلال آخر 30 يوماً التي استجابت لها الوجهة برمز HTTP 400 أو أعلى، أو لم تستجب لها (انتهاء المهلة، أو رفض الاتصال، أو عنوان محظور). average_response_time_ms: type: integer nullable: true description: >- متوسط وقت الاستجابة بالمللي ثانية على مدار آخر 30 يومًا، مقربًا إلى عدد صحيح. يكون `null` عندما لا توجد عمليات تسليم في تلك النافذة. error_rate_percentage: type: integer description: >- `round(failed_deliveries_count / deliveries_count * 100)` على مدار آخر 30 يوماً؛ `0` عند عدم وجود عمليات تسليم. last_delivery_at: type: string format: date-time nullable: true description: >- الطابع الزمني لأحدث محاولة تسليم (ناجحة أو فاشلة). يكون `null` إذا لم يتم التسليم مطلقًا. metrics_window_days: type: integer description: >- طول النافذة الزمنية بالأيام التي تغطيها الحقول `deliveries_count` و`failed_deliveries_count` و`average_response_time_ms` و`error_rate_percentage` و`daily_points`. القيمة دائماً `30`. health_status: type: string enum: - healthy - degraded - failing description: >- حالة التشغيل للتسليم. `failing`: فشل 3 أحداث متتالية أو أكثر في أول محاولة تسليم لها منذ آخر استجابة ناجحة للوجهة (راجع `failing_streak`). `degraded`: ليست في حالة failing، ولكن فشلت محاولة تسليم خلال آخر 24 ساعة ولم تنجح أي محاولة لاحقة في تسليم ذلك الحدث؛ وستؤدي إعادة المحاولة أو إعادة الإرسال التي تنجح في تسليمه إلى محو هذه الحالة. `healthy`: ليست في أي من الحالتين السابقتين. مستقلة عن `enabled`. المحاولة الفاشلة هي المحاولة التي تمت الاستجابة لها برمز HTTP 400 أو أعلى، أو لم تتم الاستجابة لها على الإطلاق. failing_streak: type: integer description: >- عدد الأحداث المتتالية التي فشلت محاولة تسليمها الأولى منذ آخر استجابة ناجحة للوجهة، خلال آخر 30 يوماً. لا تُحتسب عمليات إعادة المحاولة، وأي محاولة ناجحة، بما في ذلك إعادة المحاولة أو إعادة الإرسال، تنهي سلسلة الفشل. تكون القيمة `0` عندما لا يفشل أي حدث منذ آخر نجاح. failing_since: type: string format: date-time nullable: true description: >- وقت إجراء أول محاولة فاشلة في `failing_streak` الحالية. تكون القيمة `null` عندما تكون `failing_streak` تساوي `0`. last_success_at: type: string format: date-time nullable: true description: >- وقت آخر استجابة من الوجهة لتسليم بحالة HTTP أقل من 400، خلال آخر 30 يوماً. وتكون القيمة `null` إذا لم تُجب خلال تلك الفترة بتسليم ذي حالة HTTP أقل من 400. environment: type: string enum: - live - sandbox description: بيئة التطبيق الذي يملك الوجهة. daily_points: type: array description: >- إدخال واحد لكل يوم بتوقيت UTC خلال آخر 30 يوماً، بدءاً من الأقدم، بما في ذلك الأيام التي لم تشهد أي عمليات تسليم. يحتسب كل محاولة، بما في ذلك عمليات إعادة المحاولة. items: type: object properties: date: type: string format: date description: يوم UTC. total_deliveries: type: integer description: محاولات التسليم التي تمت في ذلك اليوم. failed_deliveries: type: integer description: >- المحاولات التي تمت في ذلك اليوم والتي تم الرد عليها برمز HTTP 400 أو أعلى، أو لم يتم الرد عليها على الإطلاق. secret_last4: type: string description: >- آخر أربعة أحرف من سر التوقيع الحالي للوجهة، لتتمكن من التمييز بين الأسرار. غير كافية للتحقق من التوقيع. created_by_email: type: string nullable: true description: >- البريد الإلكتروني لعضو Business Console الذي أنشأ الوجهة. يكون `null` بالنسبة للوجهة التي تم إنشاؤها باستخدام مفتاح API. created_by_name: type: string nullable: true description: >- اسم عضو Business Console الذي أنشأ الوجهة. `null` لوجهة تم إنشاؤها باستخدام مفتاح API. created_at: type: string format: date-time updated_at: type: string format: date-time examples: Two destinations: value: - uuid: 11111111-2222-3333-4444-555555555555 label: Production session webhooks url: https://yourapp.com/webhooks/didit enabled: true webhook_version: v3 subscribed_events: - status.updated - data.updated subscribed_events_count: 2 deliveries_count: 12453 failed_deliveries_count: 14 average_response_time_ms: 187 error_rate_percentage: 0 last_delivery_at: '2026-05-17T09:21:18Z' metrics_window_days: 30 health_status: healthy failing_streak: 0 failing_since: null last_success_at: '2026-05-17T09:21:18Z' environment: live daily_points: - date: '2026-04-18' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-19' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-20' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-21' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-22' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-23' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-24' total_deliveries: 415 failed_deliveries: 9 - date: '2026-04-25' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-26' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-27' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-28' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-29' total_deliveries: 415 failed_deliveries: 0 - date: '2026-04-30' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-01' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-02' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-03' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-04' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-05' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-06' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-07' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-08' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-09' total_deliveries: 415 failed_deliveries: 5 - date: '2026-05-10' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-11' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-12' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-13' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-14' total_deliveries: 415 failed_deliveries: 0 - date: '2026-05-15' total_deliveries: 416 failed_deliveries: 0 - date: '2026-05-16' total_deliveries: 416 failed_deliveries: 0 - date: '2026-05-17' total_deliveries: 416 failed_deliveries: 0 secret_last4: 0xnQ created_by_email: null created_by_name: null created_at: '2026-01-04T08:00:00Z' updated_at: '2026-04-22T14:09:11Z' - uuid: 22222222-3333-4444-5555-666666666666 label: Staging mirror url: https://staging.yourapp.com/webhooks/didit enabled: false webhook_version: v3 subscribed_events: - status.updated subscribed_events_count: 1 deliveries_count: 0 failed_deliveries_count: 0 average_response_time_ms: null error_rate_percentage: 0 last_delivery_at: null metrics_window_days: 30 health_status: healthy failing_streak: 0 failing_since: null last_success_at: null environment: live daily_points: - date: '2026-04-18' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-19' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-20' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-21' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-22' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-23' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-24' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-25' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-26' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-27' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-28' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-29' total_deliveries: 0 failed_deliveries: 0 - date: '2026-04-30' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-01' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-02' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-03' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-04' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-05' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-06' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-07' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-08' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-09' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-10' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-11' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-12' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-13' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-14' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-15' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-16' total_deliveries: 0 failed_deliveries: 0 - date: '2026-05-17' total_deliveries: 0 failed_deliveries: 0 secret_last4: k9Qe created_by_email: reviewer@example.com created_by_name: Example Reviewer created_at: '2026-03-12T10:15:02Z' updated_at: '2026-03-12T10:15:02Z' '403': description: >- مفتاح API مفقود أو غير صالح أو منتهي الصلاحية أو مخصص لتطبيق مختلف. يُرجع المفتاح المفقود رمز الحالة `403`؛ بينما يُرجع المفتاح الخاطئ أو الملغى أو منتهي الصلاحية رمز الحالة `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: تم تجاوز حد المعدل؛ تراجع مؤقتاً وأعد المحاولة. content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/webhook/destinations/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.webhooks.destinations.list() print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.webhooks.destinations.list(); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Webhooks.Destinations.List(ctx)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.webhooks().destinations().list(); System.out.println(result); - lang: php label: PHP source: |- webhooks->destinations->list(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.webhooks.destinations.list.each do |item| puts item.to_h end - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Webhooks.Destinations.ListAsync(); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: WebhookSubscribedEvents: type: array description: >- أداة تصفية الأحداث لوجهة webhook هذه. تسلّم Didit فقط إشعارات webhook التي يتطابق نوع الحدث الخاص بها تماماً مع إحدى هذه القيم — لا يوجد اشتراك باستخدام أحرف البدل. عند الإرسال، يجب أن تحتوي القائمة على حدث صالح واحد على الأقل (يتم رفض `[]` الصريحة بالرمز 400)؛ والوجهة التي تكون قائمتها فارغة (تم إغفال الحقل عند الإنشاء) لا تتلقى أي شيء. عند التحديث، يتم استبدال القائمة بالكامل ولا تُدمج أبداً. minItems: 1 uniqueItems: true items: $ref: '#/components/schemas/WebhookEvent' example: - status.updated - data.updated WebhookEvent: type: string description: >- اسم حدث webhook المدعوم. استخدم هذه النصوص بدقة في `subscribed_events`؛ حيث يتم رفض القيم غير المدعومة. enum: - status.updated - data.updated - user.status.updated - user.data.updated - business.status.updated - business.data.updated - activity.created - transaction.created - transaction.status.updated - travel_rule.status.updated - workflow.compliance_changed - transaction_rule_suggestions.created - auth.signup - auth.login - auth.login_failed - auth.password_reset_requested - auth.password_reset_completed - auth.mfa_changed - auth.new_device - auth.account_locked - investigator.report.ready - investigator.decision.automated - investigator.decision.overridden - investigator.decision.contested - investigator.question.raised - investigator.automation.paused - investigator.rfi.answered - investigator.rfi.overdue - investigator.drift.detected - investigator.sla.breached - investigator.qa.failed - investigator.external.report.ready securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.