الانتقال إلى المحتوى الرئيسي
POST
cURL
ابدأ التحقق من Google Wallet ID من الخادم الخلفي باستخدام مفتاح API الخاص بتطبيقك. لا تحتاج إلى سير عمل أو إلى workflow_id. تصف استجابة البدء إجراء المصادقة التالي، وهي ليست نتيجة هوية مقبولة.

التغطية والتفعيل

تفعيل المحفظة منفصل عن نشر الواجهة البرمجية وعن أهلية تطبيقك. لا يُفعّل endpoint موثّق محفظةً مُعلَّمة بعبارة «قريبًا». للاطلاع على الأسعار المنشورة الحالية، راجع أسعار محافظ الهوية الرقمية.

ما الذي يفعله الشخص

تطلب صفحتك أو تطبيقك من Google Wallet نفسها: لا توجد إعادة توجيه ولا صفحة مستضافة من Didit. مرّر next_action.digital_credentials.request إلى navigator.credentials.get({digital: request}) ضمن إيماءة من المستخدم على origin الذي بدأت به، أو إلى Android Credential Manager بوصفه GetDigitalCredentialOption. ثم أرسل ما تعيده المحفظة إلى إرسال رد المحفظة. يعرض المتصفح رمز QR الخاص به عندما تكون المحفظة على جهاز آخر.

استلام النتيجة

اتبع دليل واجهة برمجة تطبيقات محافظ الهوية الرقمية لتتبع التحقق واسترجاع نتيجته. اعتبر النتيجة المكتملة والمتحقق منها فقط دليلاً على أن المحفظة تحققت من هوية الشخص. تختلف سمات الهوية المُعادة بحسب المحفظة، فلا تفترض وجود العنوان أو الصورة الشخصية أو كل السمات المطلوبة.

ذات صلة

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

الترويسات

Idempotency-Key
string

مفتاح اختياري لأمان إعادة المحاولة (بحد أقصى 255 حرفاً). تؤدي إعادة المحاولة بنفس المفتاح والمحفظة ونص الطلب إلى إرجاع عملية التحقق الأصلية دون بدء تسجيل دخول ثانٍ؛ أما استخدام نفس المفتاح مع محفظة أو نص طلب آخر فيُرجع 409 idempotency_key_reused.

الجسم

بدء عملية تحقق عبر Google Wallet (USA، GBR، BRA، SGP، TWN).

country
enum<string>
مطلوب

رمز الدولة حسب معيار ISO 3166-1 alpha-3 لهوية Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
الخيارات المتاحة:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
مطلوب

المكان الذي ستطلب فيه صفحتك أو تطبيقك من المحفظة: أصل https الخاص بصفحتك (يجب أن يكون مضيفه ضمن allowed_return_hosts الخاصة بالتطبيق، أو يكون نطاق العلامة البيضاء الخاص به)، مثل https://app.example.com، أو android:apk-key-hash:<base64 SHA-256 لشهادة توقيع تطبيقك، دون حشو>. ترفض المحفظة الطلب في أي مكان آخر.

Required string length: 1 - 256
vendor_data
string | null

المرجع الخاص بك لعملية التحقق هذه (مثل معرّف المستخدم لديك). يُعاد في النتائج وwebhook.

metadata
object | null

كائن JSON اختياري يُخزن مع التحقق ويُعاد في النتائج وwebhook.

sandbox_scenario
string

لتطبيقات البيئة التجريبية فقط: النتيجة المحاكاة - 'wallet_cancelled' أو 'wallet_timeout' أو 'wallet_provider_error'؛ وأي سيناريو آخر (أو عدم تحديد أي سيناريو) يُكمل التحقق بنجاح. يُرفض في تطبيقات بيئة الإنتاج. القائمة الكاملة متاحة عبر GET /v1/sandbox/scenarios/.

Minimum string length: 1

الاستجابة

عملية تحقق مستقلة واحدة من المحفظة، كما تُجيب عنها كل endpoint للمحفظة.

request_id
string<uuid>
مطلوب
wallet_verification
object
مطلوب
vendor_data
string | null
مطلوب
metadata
object | null
مطلوب

كائن البيانات الوصفية المرسل في البداية، أو null.

created_at
string<date-time>
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦