> ## 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. # محفظة الهوية الرقمية: الحصول على نتيجة التحقق > اقرأ حالة عملية التحقق المستقلة من محفظة الهوية الرقمية ونتيجة الهوية المتحقَّق منها باستخدام Didit. استخدم `request_id` الذي تم إرجاعه عند بدء التحقق. قم بالمصادقة باستخدام مفتاح API يخص التطبيق نفسه. التحقق المعلّق لم يثبت هوية الشخص بعد. تحقّق من النتيجة النهائية قبل استخدام الهوية المُرجَعة كبيانات موثّقة. تختلف السمات الخاصة بالمحفظة حسب المحفظة والدولة. في حالة الموافقة عبر الهاتف، استخدم [استطلاع التحقق من المحفظة](https://docs.didit.me/ar/standalone-apis/digital-id-wallet-poll.md) لمتابعة فحص المصادقة. للاطلاع على تسلسل التكامل الكامل، راجع [واجهات برمجة تطبيقات محفظة الهوية الرقمية](https://docs.didit.me/ar/standalone-apis/digital-id-wallets.md). ## OpenAPI ````yaml ar/openapi-25.json GET /v3/id-verification/wallets/verifications/{request_id}/ 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/id-verification/wallets/verifications/{request_id}/: get: tags: - Digital ID wallets summary: الحصول على التحقق من المحفظة description: >- حالة ونتيجة التحقق من المحفظة: الهوية الموحدة والسمات الخاصة بالمحفظة بمجرد التحقق منها، ورمز الخطأ بمجرد الرفض، والإجراء التالي طالما كانت معلقة. تكون نتيجة التحقق الذي تجاوز expires_at هي timeout. operationId: get_wallet_verification parameters: - in: path name: request_id schema: type: string format: uuid description: قيمة request_id التي أرجعها الـ endpoint للبدء. required: true responses: '200': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: ftn name: Finnish Trust Network issuing_authority: Finnish banks and mobile operators (FTN) country: FIN status: Not Finished outcome: pending error: null interaction: redirect simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: type: redirect url: https://wallet.example.com/authorize identity: null attributes: null level_of_assurance: null verified_at: null signature_valid: null credential_type: person_identification vendor_data: your-customer-reference metadata: reference: example created_at: '2026-01-01T10:00:00Z' description: '' '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage description: 'بيانات اعتماد مفقودة (x-api-key أو Authorization: Bearer).' '404': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- الخطأ not_found: لا توجد عملية تحقق من المحفظة لهذا التطبيق تتضمن request_id هذا. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url https://verification.didit.me/v3/id-verification/wallets/verifications/REQUEST_ID/ \ --header 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.id_wallets.retrieve_verification( "11111111-2222-3333-4444-555555555555", ) 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.idWallets.retrieveVerification("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.IDWallets.RetrieveVerification(ctx, \"11111111-2222-3333-4444-555555555555\")\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.idWallets().retrieveVerification("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- idWallets->retrieveVerification('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.id_wallets.retrieve_verification("11111111-2222-3333-4444-555555555555") puts result.to_h - 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.IdWallets.RetrieveVerificationAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: DigitalIdWalletApiWalletVerificationResponse: type: object description: عملية تحقق مستقلة واحدة من المحفظة، كما تُجيب عنها كل endpoint للمحفظة. properties: request_id: type: string format: uuid wallet_verification: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationResult' vendor_data: type: string nullable: true metadata: type: object additionalProperties: {} nullable: true description: كائن البيانات الوصفية المرسل في البداية، أو null. created_at: type: string format: date-time required: - created_at - metadata - request_id - vendor_data - wallet_verification DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: رمز ثابت قابل للقراءة آلياً، مثل wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- غير منتهية أثناء الانتظار، ثم تصبح مقبولة (تم التحقق منها) أو مرفوضة. outcome: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResultOutcomeEnum error: type: string nullable: true readOnly: true interaction: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiInteractionEnum' readOnly: true simulated: type: boolean readOnly: true expires_at: type: string format: date-time next_action: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextAction' nullable: true readOnly: true identity: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletIdentity' nullable: true readOnly: true attributes: type: object additionalProperties: {} nullable: true readOnly: true level_of_assurance: type: string nullable: true verified_at: type: string format: date-time nullable: true signature_valid: type: boolean nullable: true description: >- تكون القيمة True بمجرد التحقق من توقيع بيانات الاعتماد؛ وتكون null لبيانات الاعتماد المحاكاة. credential_type: type: string nullable: true required: - attributes - country - credential_type - error - expires_at - identity - interaction - level_of_assurance - next_action - outcome - signature_valid - simulated - status - verified_at - wallet DigitalIdWalletApiWallet: type: object properties: id: type: string description: معرّف الدليل للمحفظة، مثل bankid_se. name: type: string issuing_authority: type: string nullable: true required: - id - issuing_authority - name DigitalIdWalletApiWalletVerificationResultOutcomeEnum: enum: - pending - verified - cancelled - timeout - failed type: string description: |- * `pending` - قيد الانتظار * `verified` - تم التحقق * `cancelled` - ألغاها المستخدم * `timeout` - انتهت المهلة * `failed` - فشلت DigitalIdWalletApiInteractionEnum: enum: - redirect - in_app - digital_credentials type: string description: |- * `redirect` - redirect * `in_app` - in_app * `digital_credentials` - digital_credentials DigitalIdWalletApiWalletNextAction: type: object properties: type: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextActionTypeEnum' description: >- redirect: إرسال متصفح المستخدم إلى url. confirm_in_app: إظهار verification_code للمستخدم، ليتحقق من مطابقته للرمز في تطبيق محفظته ويؤكد من هناك؛ ثم إجراء استقصاء دوري. request_digital_credential: عبر إجراء من المستخدم على المصدر (origin) الذي بدأت منه، اطلب من المحفظة باستخدام digital_credentials.request، ثم أرسل النتيجة المستلمة إلى POST .../verifications/{request_id}/response/. * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential url: type: string format: uri description: 'لحالة redirect فقط: حيث يسجل المستخدم الدخول باستخدام المحفظة.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- لحالة request_digital_credential فقط: الطلب الذي يتم تسليمه إلى المحفظة. verification_code: type: string description: >- لـ confirm_in_app فقط: رمز المقارنة المكون من 4 أرقام والذي يعرضه تطبيق المحفظة أيضاً. poll_interval_seconds: type: integer description: >- لـ confirm_in_app فقط: معدل استدعاء POST .../verifications/{request_id}/poll/ للحصول على استجابة فورية. تُجري Didit أيضاً استطلاعاً لعمليات تسجيل الدخول المعلقة في الخلفية، لذلك يبلّغ الـ webhook عن النتيجة حتى لو لم تقم بالاستطلاع. required: - type DigitalIdWalletApiWalletIdentity: type: object properties: full_name: type: string nullable: true first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string format: date nullable: true nationality: type: string nullable: true description: >- الجنسية بتنسيق ISO3، فقط عندما تؤكدها المحفظة (لا يتم استنتاجها أبداً). issuing_state: type: string description: الدولة بتنسيق ISO3 التي أصدر مخططها الهوية. required: - date_of_birth - first_name - full_name - issuing_state - last_name - nationality DigitalIdWalletApiWalletNextActionTypeEnum: enum: - redirect - confirm_in_app - request_digital_credential type: string description: |- * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential DigitalIdWalletApiWalletDigitalCredentialsRequest: type: object properties: protocol: type: string description: openid4vp-v1-signed. request: type: object additionalProperties: {} description: >- مرّره كما هو: navigator.credentials.get({digital: request}) في المتصفح، أو JSON.stringify(request) كـ requestJson لـ GetDigitalCredentialOption على Android. موقّع بواسطة Didit لتطبيقك. required: - protocol - request 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. BearerAuth: type: http scheme: bearer description: token الوصول الخاص باعتماد العميل للتطبيق. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.