POST
StartDeviceLogin
StartDeviceLogin creates a short-lived cross-device authorization request.
/api.v1.auth.AuthService/StartDeviceLogin Public01
Request
StartDeviceLoginRequest
StartDeviceLoginRequestapi.v1.auth.StartDeviceLoginRequest2 fields
Start Device Login Request message.
deviceTypeDeviceTypeDevice Type value.
deviceNamestringA short, non-authoritative label shown below the server-controlled platform name.
{
"deviceType": "UNSPECIFIED",
"deviceName": "string"
}02
Response
StartDeviceLoginResponse
StartDeviceLoginResponseapi.v1.auth.StartDeviceLoginResponse6 fields
Start Device Login Response message.
deviceCodestringA high-entropy secret held only by the requesting device. It must never be displayed.
userCodestringA short code displayed on both devices for manual entry and request comparison.
verificationUristringVerification Uri value.
verificationUriCompletestringVerification Uri Complete value.
expiresInint32Expires In value.
intervalint32Interval value.
{
"deviceCode": "string value",
"userCode": "string value",
"verificationUri": "string value",
"verificationUriComplete": "string value",
"expiresIn": 1,
"interval": 1
}03
Error handling
Common failure codes
invalid_argumentThe request payload failed validation.
internalThe service could not complete the operation.