Nest API Codes

Sundry ›› Nest Gateway ››
Parent Previous Next

Nest API Codes

This is the Nest API Status Code List.

NEST web services API Specification Guide v3.0


Table 1: HTTP status code list

               

               200

OK

               201

Created

               202

Accepted

               302

Found

               400

Bad request

               401

Unauthorized

               403

Forbidden

               404

Not Found

               405

Method not allowed

               406

Not acceptable

               413

Request entity too large

               415

Unsupported Media Type

               422

Unprocessable entity

               429

Too many requests

               431

Request header fields too large

               500

Internal server error

               503

Service unavailable


Some of the common scenarios where each status code will be provided are outlined below


200: This status code would be sent back while checking the status of the request made. If the processing is not

complete, an indication would be sent back stating that the request processing is pending for completion.

When the final response is requested by the payroll client and after it is served, this status code would be sent

back.

201: If the processing has been completed for the given request, 201 status code will be returned.

202: When the initial request is made, 202 would be sent back to indicate to the payroll client that response would

not be available immediately, however, the request has been successfully accepted.

302: This would be sent back if the base URL is incorrect.

400: If the XML does not confirm to XSD or if there any security validation failures, then 400 status code will be

returned.

401: This would be sent back when invalid credentials were supplied.

403: This would be sent back if the requested service is valid, but the user does not have permissions to access

the service.

This would be sent back if the employer submits a request with invalid Employer Reference Number.

404: This would be sent back when the requested resource is not present/invalid.

405: This would be sent back if the PSP client tries to perform an unsupported operation.

406: This would be sent back if the data to be returned is not acceptable to the payroll client.

413: This would be sent back if the request is too large. For example if the XML can be only 2 MB of size

maximum, and if the input XML exceeds 2 MB, then this status code would be sent back.

415: This would be sent back if the request comes with an unsupported Media type.

422: This would be sent back if the provided input is unprocessable e.g. malformed xml

429: If NEST is processing an abnormally high number of requests and is unable to process any further at that

time, this status code will be sent back

431: If the headers in the request are too long, then this status code would be sent back.

500: If NEST system is unable to process the request owing to some issue, this would sent back. The exception to

this is that when a request is submitted with special characters in HTTP headers, a 500 error is thrown instead

of a 400. This is due to a technical limitation in the processing systems.

503: If NEST system is unavailable due to maintenance or for any other reason, then this would be sent back

Created with the Personal Edition of HelpNDoc: Full-featured EBook editor