Method: vdc.proofUser

نقطة نهاية لإثبات هوية المستخدم باستخدام قائمة مستندات إثبات الهوية التي تحدّدها جهة الإصدار، وذلك لجهاز معيّن.

طلب HTTP

POST https://example.issuer.com/api/v1/vdc/proofUser

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string,
  "evidence": [
    {
      object (ProofingEvidence)
    }
  ],

  // Union field proofing_context can be only one of the following:
  "reverificationContext": {
    object (ReverificationContext)
  }
  // End of list of possible types for union field proofing_context.
}
الحقول
requestMetadata

object (RequestMetadata)

البيانات الوصفية المتعلّقة بالطلب، وهي مطلوبة في جميع الطلبات
deviceReferenceId

string

المعرّف الذي يتوافق مع الجهاز ومفتاح الهوية المرتبط بالجهاز هذا ليس معرّف جهاز، ما يعني أنّه إذا كان لدى المستخدم بيانات اعتماد منفصلة على الجهاز نفسه، سيختلف هذا المعرّف بينهما.

يتم تقديم رقم التعريف هذا في جميع الطلبات، ويمكن استخدامه لربط الطلبات.
proofingId

string

معرّف مبهم يمثّل عملية إثبات هوية تتضمّن حزمة معيّنة من المستندات لجهاز معيّن.

مثال: UUID
evidence[]

object (ProofingEvidence)

قائمة المستندات المطلوبة لإثبات هوية المستخدم للحصول على مستند تعريف رقمي
حقل الربط proofing_context تمثّل هذه السمة سياق إثبات الملكية. اترك هذا الحقل فارغًا لإجراء عملية إثبات الملكية الأولية. يمكن أن يكون التعليق proofing_context إحدى القيم التالية فقط:
reverificationContext

object (ReverificationContext)

تمثّل هذه السمة سياق عملية إثبات ملكية الحساب لإعادة التحقّق منه.

نص الاستجابة

إشعار باستلام طلب إثبات هوية المستخدم للحصول على بيانات اعتماد رقمية، يشير إلى أنّ عملية إثبات الهوية قيد المعالجة حاليًا.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
الحقول
responseMetadata

object (ResponseMetadata)

البيانات الوصفية الخاصة بالرد، وهي مطلوبة في جميع الردود.
proofingId

string

المعرّف غير الشفاف الذي يمثّل عملية إثبات هوية باستخدام حزمة محدّدة من المستندات لجهاز معيّن وهو رقم تعريف المستند نفسه الذي تم إرساله في الطلب.

ProofingEvidence

تمثّل هذه السمة مستندًا واحدًا.

تمثيل JSON 
{

  // Union field evidence_type can be only one of the following:
  "preAuthorizationCode": {
    object (Evidence)
  }
  // End of list of possible types for union field evidence_type.
}
الحقول
حقل الربط evidence_type حقل oneof يشير إلى طريقة عرض مستند الإثبات. يمكن أن يكون التعليق evidence_type إحدى القيم التالية فقط:
preAuthorizationCode

object (Evidence)

رمز التفويض المُسبَق الذي أرسلته جهة الإصدار

الدليل

تمثّل هذه السمة مستندًا واحدًا.

تمثيل JSON 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string,
  "unencryptedInteger": integer
  // End of list of possible types for union field presencetype.
}
الحقول
حقل الربط presencetype حقل oneof يشير إلى طريقة عرض مستند الإثبات. يمكن أن يكون التعليق presencetype إحدى القيم التالية فقط:
encryptedData

object (EncryptedData)

القيمة المشفّرة والبيانات الوصفية للتشفير اللازمة لفك تشفير القيمة
unencryptedValue

string

قيمة الدليل المرمّزة باستخدام Base64
unencryptedInteger

integer

قيمة العدد الصحيح للدليل.

ReverificationContext

السياق المطلوب لتفعيل إعادة إثبات صحة بيانات الاعتماد

تمثيل JSON 
{
  "credentialId": string
}
الحقول
credentialId

string

معرّف بيانات الاعتماد الذي يتم إجراء عملية إعادة التحقّق منه.