NFL Customized Error Response

Sometimes standard HTTP error codes do not provide enough information to client developers. For example, there are lots of reasons causing a HTTP call returning 401 - Unauthorized, developers have no clue what is wrong when seeing a 401 response. NFL Customized Error Codes carry meaningful information to help developers to determine the root causes for failed request calls. Error Response is wrapped in JSON format.

Error Response :

Name Type Description
errorCode Integer NFL customized error code
message String The root cause for the error
timestamp Long When the error occurs (milliseconds since January 1, 1970, 00:00:00 GMT)

Error Response Example:

{
    "errorCode" : 7000,
    "message" : "password is invalid",
    "timestamp" : 1430866592883
}

Error Code List

Identity

SSO

Code Description
6000 This error occurs when the system cannot find or authenticate a Credential
7000 This error occurs when the system cannot find provided resource owners or username/password does not match what in the system
8000 This error when clients try to use unsupport OAuth 2.0 grant type

User Manager

Code Description
9000 This error indicates the device is not found for given device id or username
9100 This error indicates the role is not found for given device id or username
9200 This error indicates the user is not found for given device id or username