Get Device Code

v1.0.0

The client device calls the DigiLocker API to get the device code by providing the client_id issued to the device OEM and either the username or the mobile number of the user. DigiLocker responds with a device code and then sends an OTP on the mobile number and email address associated with the user’s account. The masked mobile number and email address is also sent in response. The device should use these values to notify the users about the mobile and email address on which the OTP has been sent.

Input

{
  "properties": {
    "client_id": {
      "type": "string"
    },
    "dl_mobile": {
      "type": "integer",
      "description": "Mobile number associated with DigiLocker account of the\n  user. The client device accepts the mobile number on the device from user and sends it in this parameter. Either the username or the mobile number must be provided."
    },
    "dl_username": {
      "type": "string",
      "description": "DigiLocker username of the user. The client device accepts the username on the device from user and sends the username in this parameter. Either the username or the mobile number must be provided.   "
    },
    "response_type": {
      "type": "string",
      "description": "The parameter must be set to device_code."
    }
  }
}

Output

{
  "type": "object",
  "required": [
    "device_code",
    "dl_masked_email",
    "dl_masked_mobile",
    "expires_in"
  ],
  "properties": {
    "device_code": {
      "type": "string",
      "description": "The device verification code."
    },
    "dl_masked_email": {
      "type": "string",
      "description": "The masked email on which the OTP is sent."
    },
    "dl_masked_mobile": {
      "type": "integer",
      "description": "The masked mobile number on which the OTP is sent."
    },
    "expires_in": {
      "type": "integer",
      "description": "The duration in seconds for which the code is valid."
    }
  }
}