Method: vdc.provisionCredential

Endpoint untuk menyediakan kredensial.

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "credentialId": string,
  "proofingId": string,
  "deviceEncryptionKey": {
    object (DeviceEncryptionKey)
  }
}
Kolom
requestMetadata

object (RequestMetadata)

Wajib. Metadata tentang permintaan, yang diperlukan dalam semua permintaan.
deviceReferenceId

string

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

ID ini diberikan dalam semua permintaan, dan dapat digunakan untuk mengorelasikan permintaan.
credentialId

string

Wajib. ID buram yang mewakili kredensial tertentu yang disediakan untuk perangkat.

Jika credentialId sudah ada, metode ini akan menampilkan kredensial yang ada, bukan membuat kredensial baru.

Contoh: UUID
proofingId

string

Wajib. ID buram yang mewakili verifikasi dengan paket bukti tertentu, untuk perangkat tertentu.

Verifikasi harus dalam status Disetujui. Jika tidak, ErrorResponse ID tidak valid akan ditampilkan.
deviceEncryptionKey

object (DeviceEncryptionKey)

Wajib. Objek yang berisi kunci enkripsi sementara perangkat dan metadata terkait. Kunci ini digunakan untuk mengenkripsi nilai kembali ke perangkat. Objek ini mungkin tidak disediakan di lingkungan sandbox selama orientasi, yang menunjukkan bahwa penerbit harus menampilkan data teks biasa. Objek ini harus selalu ditetapkan di lingkungan produksi.

Isi respons

Respons yang berisi kredensial yang disediakan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "credential": {
    object (Credential)
  },
  "credentialVersionId": string
}
Kolom
responseMetadata

object (ResponseMetadata)

Wajib. Metadata tentang respons, yang diperlukan dalam semua respons.
credential

object (Credential)

Wajib. Kredensial yang disediakan.
credentialVersionId

string

Wajib. Versi kredensial saat ini yang telah disediakan.

Kredensial

Kredensial berbasis mdoc, seperti yang ditentukan oleh standar ISO yang relevan untuk jenis kredensial.

Misalnya, untuk SIM seluler, ini akan menjadi ISO/IEC 18013-5. Lihat ini untuk format mDoc mDL.

Representasi JSON 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string
  // End of list of possible types for union field presencetype.
}
Kolom
Kolom union presencetype. Wajib. Satu dari yang menunjukkan cara kredensial ditampilkan. presencetype hanya ada berupa salah satu diantara berikut:
encryptedData

object (EncryptedData)

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

string

Nilai kredensial yang dienkode base64.