Method: vdc.proofUser

Endpoint untuk membuktikan pengguna untuk kredensial digital, menggunakan daftar bukti yang ditentukan penerbit, dan untuk perangkat tertentu.

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
requestMetadata

object (RequestMetadata)

Metadata tentang permintaan, yang diperlukan dalam semua permintaan.
deviceReferenceId

string

ID yang sesuai dengan perangkat dan kunci identitas yang terkait dengan perangkat. ID ini BUKAN ID perangkat, artinya jika pengguna memiliki dua kredensial terpisah di perangkat yang sama, ID ini akan berbeda di antara keduanya.

ID ini diberikan di semua permintaan, dan dapat digunakan untuk mengorelasikan permintaan.
proofingId

string

ID buram yang merepresentasikan pembuktian dengan sekumpulan bukti tertentu, untuk perangkat tertentu.

Contoh: UUID
evidence[]

object (ProofingEvidence)

Daftar bukti yang diperlukan untuk membuktikan pengguna memiliki kredensial digital.
Kolom union proofing_context. Konteks untuk pemeriksaan. Kosong untuk pembuktian awal. proofing_context hanya dapat berupa salah satu dari berikut:
reverificationContext

object (ReverificationContext)

Konteks untuk pembuktian verifikasi ulang.

Isi respons

Konfirmasi atas permintaan untuk memverifikasi pengguna untuk kredensial digital, yang menunjukkan bahwa verifikasi sedang diproses.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
Kolom
responseMetadata

object (ResponseMetadata)

Metadata tentang respons, yang diperlukan dalam semua respons.
proofingId

string

ID buram yang merepresentasikan pembuktian dengan kumpulan bukti tertentu, untuk perangkat tertentu. Ini adalah ID bukti yang sama dengan yang dikirim dalam permintaan.

ProofingEvidence

Objek yang merepresentasikan satu bukti.

Representasi 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.
}
Kolom
Kolom union evidence_type. Oneof yang menunjukkan cara bukti disajikan. evidence_type hanya dapat berupa salah satu dari berikut:
preAuthorizationCode

object (Evidence)

Kode pra-otorisasi yang dikirim dari penerbit.

Bukti

Objek yang merepresentasikan satu bukti.

Representasi 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.
}
Kolom
Kolom union presencetype. Oneof yang menunjukkan cara bukti disajikan. presencetype hanya dapat berupa salah satu dari berikut:
encryptedData

object (EncryptedData)

Nilai terenkripsi dan metadata enkripsi yang diperlukan untuk mendekripsi nilai.
unencryptedValue

string

Nilai berenkode base64 dari bukti.
unencryptedInteger

integer

Nilai bilangan bulat bukti.

ReverificationContext

Konteks yang diperlukan untuk memicu verifikasi ulang kredensial.

Representasi JSON 
{
  "credentialId": string
}
Kolom
credentialId

string

ID kredensial yang diverifikasi ulang.