Requesting a device registration code (registering device)

Request

When the user requests companion device sign-on on the device that is not yet signed in, the application should send a GET request to:

https://<host>:<port>/dsra/v1/user/deviceRegistrationCode

Headers

• x-correlation-id – identifier for logging, to correlate messages across a call flow

Response

A successful response returns an HTTP 200 status. The response body contains:

• deviceRegistrationCode – the device registration code to be displayed to the user

• dsraToken – the DSRA token that the app will need when it a requests a sign-on/activation token

• expiresAfterMillis – the expiration period in seconds. When requesting a sign-on/activation token, the request will fail if made after the end of this period.

• pollingPeriodSeconds – the polling period for the sign-on/activation token request

If there is a conflict error (that is, the service cannot generate a unique device registration code), the service returns an HTTP 409 status.

See also

Device SignOn and Registration Assistant (DSRA) API documentation