Method: vdc.getDeviceRegistrationNonce

Ein Endpunkt, um eine Geräteregistrierungs-Nonce anzufordern.

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string
}
Felder
requestMetadata

object (RequestMetadata)

Die Metadaten zur Anfrage, erforderlich in allen Anfragen.
deviceReferenceId

string

Die zum Gerät gehörende ID und der mit dem Gerät verknüpfte Identitätsschlüssel. Dabei handelt es sich NICHT um eine Geräte-ID. Wenn ein Nutzer zwei verschiedene Ausweisdokumente auf demselben Gerät verwendet, unterscheidet sich diese ID bei beiden voneinander.

Die ID wird bei allen Anfragen angegeben und kann dazu verwendet werden, Anfragen zu korrelieren.

Antworttext

Eine Antwort, die die Geräteregistrierungs-Nonce enthält.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "nonce": string
}
Felder
responseMetadata

object (ResponseMetadata)

Die Metadaten zur Antwort, erforderlich in allen Antworten.
nonce

string

Die Nonce für die Geräteregistrierung. Aufgrund einer Einschränkung in der Android IdentityCredential-Bibliothek darf sie maximal 32 Byte lang sein.