> ## 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. # التحقق من الهوية عبر ConnectID: واجهة برمجة التطبيقات > ادمج التحقق من الهوية عبر ConnectID مع تطبيقك الخاص باستخدام Didit. اطّلع على تغطية الدول وخطوات المصادقة والنتائج والأسعار. ابدأ التحقق عبر ConnectID من الخادم الخاص بك باستخدام مفتاح API للتطبيق. لا تحتاج إلى سير العمل أو `workflow_id`. تصف استجابة البدء إجراء المصادقة التالي، وهي ليست نتيجة هوية مقبولة. ## التغطية والتفعيل | الخاصية | القيمة | | - | - | | المحفظة | ConnectID | | معرّف المحفظة | `connectid` | | الدول | ![](https://didit-public-assets.s3.eu-west-1.amazonaws.com/flags/au.svg)أستراليا | | تفعيل المحفظة في الإنتاج | ⏳ قريباً | | سعر المحفظة المنشور | قريباً | يختلف تفعيل المحفظة عن نشر واجهة API وعن أهلية تطبيقك. لا يؤدي توفر endpoint موثّق إلى تفعيل محفظة موسومة بأنها «قريبًا». للاطلاع على الأسعار المنشورة حالياً، راجع [أسعار محفظة الهوية الرقمية](https://docs.didit.me/ar/getting-started/pricing.md#تسعير-محفظة-الهوية-الرقمية). ## ما يفعله الشخص اتبع الإجراء التالي الذي تعيده طلب البدء. تحدد تجربة المصادقة في المحفظة ما إذا كان الشخص سيستخدم متصفحاً أو جهازاً آخر أو تطبيقاً. ## استلام النتيجة اتبع [دليل واجهة برمجة تطبيقات محفظة الهوية الرقمية](https://docs.didit.me/ar/standalone-apis/digital-id-wallets.md) لتتبع عملية التحقق واسترجاع نتيجتها. اعتبر النتيجة المكتملة والموثقة فقط دليلاً على أن المحفظة صادقت على الشخص. تختلف سمات الهوية المعادة من محفظة إلى أخرى، فلا تفترض وجود العنوان أو الصورة الشخصية أو جميع السمات المطلوبة. ## ذات صلة * [واجهات برمجة تطبيقات محفظة الهوية الرقمية](https://docs.didit.me/ar/standalone-apis/digital-id-wallets.md) * [تغطية المحفظة وسماتها](https://docs.didit.me/ar/core-technology/id-verification/digital-id-wallets.md) * [الأسعار](https://docs.didit.me/ar/getting-started/pricing.md#تسعير-محفظة-الهوية-الرقمية) ## OpenAPI ````yaml ar/openapi-25.json POST /v3/id-verification/wallets/connectid/ 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/connectid/: post: tags: - Digital ID wallets summary: بدء التحقق عبر ConnectID description: >- بدء تسجيل الدخول عبر ConnectID (Australian Payments Plus؛ AUS) بدون أي سير عمل. تتم الفوترة مرة واحدة، فقط عند التحقق من الهوية. تحمل الاستجابة next_action.type=redirect مع عنوان URL لتوجيه متصفح المستخدم إليه؛ ويعود المستخدم إلى return_url مع إرفاق request_id وresult. اقرأ النتيجة عبر GET /v3/id-verification/wallets/verifications/{request_id}/ أو من webhook، وليس من عنوان URL أبداً. تحصل تطبيقات البيئة التجريبية على محاكاة حتمية (simulated: true) لا تتصل بالمزود أبداً. operationId: start_connectid_wallet_verification parameters: - in: header name: Idempotency-Key schema: type: string description: >- مفتاح اختياري لأمان إعادة المحاولة (بحد أقصى 255 حرفاً). تؤدي إعادة المحاولة بنفس المفتاح والمحفظة ونص الطلب إلى إرجاع عملية التحقق الأصلية دون بدء تسجيل دخول ثانٍ؛ أما استخدام نفس المفتاح مع محفظة أو نص طلب آخر فيُرجع 409 idempotency_key_reused. requestBody: content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiConnectidWalletVerificationStartRequest example: country: AUS vendor_data: your-customer-reference metadata: reference: example return_url: https://app.example.com/identity/complete application/x-www-form-urlencoded: schema: $ref: >- #/components/schemas/DigitalIdWalletApiConnectidWalletVerificationStartRequest multipart/form-data: schema: $ref: >- #/components/schemas/DigitalIdWalletApiConnectidWalletVerificationStartRequest required: true responses: '201': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: connectid name: ConnectID issuing_authority: Australian Payments Plus country: AUS 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: '' '400': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartBadRequest description: >- أخطاء التحقق من صحة الحقول ({field: [messages]})، أو الخطأ return_url_invalid، return_url_not_allowed، invalid_personal_code، invalid_phone_number أو idempotency_key_invalid. '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationStartForbidden description: >- بيانات اعتماد مفقودة ({detail})، أو الخطأ wallet_unavailable، أو insufficient_credits، أو contract_rate_missing. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- الخطأ idempotency_key_reused أو idempotency_key_in_progress (مع Retry-After). '502': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- الخطأ wallet_provider_unavailable: تعذر بدء تشغيل المزود؛ لم يتم إنشاء أي شيء. '503': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: 'الخطأ wallet_not_configured: لا يمكن لهذه البيئة الوصول إلى المحفظة.' security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/connectid/ \ --header 'x-api-key: YOUR_API_KEY' \ --header 'Idempotency-Key: your-unique-attempt-key' \ --header 'Content-Type: application/json' \ --data '{ "country": "AUS", "vendor_data": "your-customer-reference", "metadata": { "reference": "example" }, "return_url": "https://app.example.com/identity/complete" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.id_wallets.start_connectid( vendor_data="your-customer-reference", metadata={"reference": "example"}, country="AUS", return_url="https://app.example.com/identity/complete", ) 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.startConnectid({ vendor_data: "your-customer-reference", metadata: { reference: "example" }, country: "AUS", return_url: "https://app.example.com/identity/complete", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.IDWallets.StartConnectid(ctx, didit.IDWalletsStartConnectidParams{\n\tBody: didit.DigitalIDWalletAPIConnectidWalletVerificationStartRequest{\n\t\tVendorData: didit.String(\"your-customer-reference\"),\n\t\tMetadata: didit.Some(map[string]any{\"reference\": \"example\"}),\n\t\tCountry: didit.Some(didit.DigitalIDWalletAPIConnectidWalletVerificationStartCountryEnum(\"AUS\")),\n\t\tReturnURL: \"https://app.example.com/identity/complete\",\n\t},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.Map; import me.didit.Didit; import me.didit.types.DigitalIdWalletApiConnectidWalletVerificationStartCountryEnum; import me.didit.types.DigitalIdWalletApiConnectidWalletVerificationStartRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.idWallets().startConnectid(DigitalIdWalletApiConnectidWalletVerificationStartRequest.builder() .vendorData("your-customer-reference") .metadata(Map.of("reference", "example")) .country(DigitalIdWalletApiConnectidWalletVerificationStartCountryEnum.of("AUS")) .returnUrl("https://app.example.com/identity/complete") .build()); System.out.println(result); - lang: php label: PHP source: |- idWallets->startConnectid([ 'vendor_data' => 'your-customer-reference', 'metadata' => ['reference' => 'example'], 'country' => 'AUS', 'return_url' => 'https://app.example.com/identity/complete', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.id_wallets.start_connectid( vendor_data: "your-customer-reference", metadata: { reference: "example" }, country: "AUS", return_url: "https://app.example.com/identity/complete" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.IdWallets.StartConnectidAsync(new DigitalIdWalletApiConnectidWalletVerificationStartRequest { VendorData = "your-customer-reference", Metadata = new Dictionary { ["reference"] = "example" }, Country = new DigitalIdWalletApiConnectidWalletVerificationStartCountryEnum("AUS"), ReturnUrl = "https://app.example.com/identity/complete", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: DigitalIdWalletApiConnectidWalletVerificationStartRequest: type: object description: بدء عملية تحقق عبر ConnectID (AUS). properties: vendor_data: type: string nullable: true description: >- المرجع الخاص بك لعملية التحقق هذه (مثل معرّف المستخدم لديك). يُعاد في النتائج وwebhook. metadata: type: object additionalProperties: {} nullable: true description: كائن JSON اختياري يُخزن مع التحقق ويُعاد في النتائج وwebhook. sandbox_scenario: type: string minLength: 1 description: >- لتطبيقات البيئة التجريبية فقط: النتيجة المحاكاة - 'wallet_cancelled' أو 'wallet_timeout' أو 'wallet_provider_error'؛ وأي سيناريو آخر (أو عدم تحديد أي سيناريو) يُكمل التحقق بنجاح. يُرفض في تطبيقات بيئة الإنتاج. القائمة الكاملة متاحة عبر GET /v1/sandbox/scenarios/. country: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiConnectidWalletVerificationStartCountryEnum default: AUS description: >- دولة هوية ConnectID وفق المعيار ISO 3166-1 alpha-3. القيمة الافتراضية هي AUS، وهي الدولة الوحيدة التي تخدمها. * `AUS` - AUS authorisation_server_id: type: string minLength: 1 description: >- معرّف خادم التفويض المحدد باستخدام أداة اختيار البنك الخاصة بـ ConnectID. يتم التعيين افتراضياً في البيئة التجريبية إلى Mock Bank A. maxLength: 36 return_url: type: string format: uri minLength: 1 description: >- عنوان URL بصيغة https يعود إليه متصفح المستخدم بعد المحفظة، مع إلحاق request_id وresult. يجب أن يكون المضيف مسجلاً في allowed_return_hosts للتطبيق (أو يكون نطاق العلامة البيضاء الخاص به). لا تعتمد أبداً على result بمفردها: اقرأ النتيجة عبر GET .../verifications/{request_id}/ أو webhook. maxLength: 2048 device: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiDeviceEnum' default: same_device description: >- القيمة same_device عندما يسجل المستخدم الدخول على الجهاز الذي يعرض صفحتك، وcross_device عندما يستخدم جهازاً آخر (مثل رمز QR الخاص بـ BankID). * `same_device` - same_device * `cross_device` - cross_device required: - return_url 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 DigitalIdWalletApiWalletVerificationStartBadRequest: oneOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationFieldErrors' DigitalIdWalletApiWalletVerificationStartForbidden: oneOf: - $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage - $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: رمز ثابت قابل للقراءة آلياً، مثل wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiConnectidWalletVerificationStartCountryEnum: enum: - AUS type: string description: '* `AUS` - AUS' DigitalIdWalletApiDeviceEnum: enum: - same_device - cross_device type: string description: |- * `same_device` - same_device * `cross_device` - cross_device 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 DigitalIdWalletApiWalletVerificationFieldErrors: type: object description: 'أخطاء التحقق من صحة الطلب: كل حقل مرفوض مع رسائله.' additionalProperties: type: array items: type: string DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission 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.