Device Authorization

Authorizes a device using the customer account number and optional parameters

Resource URIs

URI Description

/admin/api/{apiKey}/external/{locationUrlName}/authorizeDevice

Authorize a device

GET/POST Parameters

externalId
Requirred. A string representing the customer account number. This can be up to 14 characters.
macAddress
Optional. The device MAC address, formatted as aa:bb:cc:dd:ee:ff.
userAgent
Optional. A string representing the user agent of a device.
username
Optional. Username of the device.
screenHeight
Optional. Necessary to exclude iPhone 4s and iPad 2 and earlier devices from hotspot 2 support.
screenWidth
Optional. Necessary to exclude iPhone 4s and iPad 2 and earlier devices fromhotspot 2 support.

Usage Guidelines

Note: The userAgent parameter is optional. However, if the user agent is not part of the enrollment record, other API calls may not return the correct OS family.

Optional parameters, if specified, are set in the device record.

Examples

http://test.company.net/admin/api/zAdBCLcgrwca/external/Production/authorizeDevice?externalId=123456789012&macAddress=aa:bb:cc:dd:ee:ff&username=bob&userAgent=Mozilla%2F5.0%20(iPad%3B%20CPU%20OS%208_3%20like%20Mac%20OS%20X)%20AppleWeb Kit%2F537.51.1%20(KHTML%2C%20like%20Gecko)%20CriOS%2F30.0.1599.12%20Mobile%2F11A46 5%20Safari%2F8536.25%20

Parent topic: External Queries