Updated on 2022-08-05 GMT+08:00

Status Codes

A status code is an HTTPS response issued by DIS to indicate whether an API request has been successfully completed.

Status Code

Status

Description

100

Continue

The server has received the initial part of the request and the client should continue to send the remaining part.

It is issued on a provisional basis while request processing continues. It alerts the client to wait for a final response.

101

Switching Protocols

The requester has asked the server to switch protocols and the server has agreed to do so. The target protocol must be more advanced than the source protocol.

For example, the current HTTP protocol is switched to a later version of HTTP.

200

OK

The server has successfully processed the request.

201

Created

The request has been fulfilled, resulting in the creation of a new resource.

202

Accepted

The request has been accepted for processing, but the processing has not been completed.

203

Non-Authoritative Information

The server successfully processed the request, but is returning information that may be from another source.

204

NoContent

The server has successfully processed the request, but does not return any content.

The status code is returned in response to an HTTPS OPTIONS request.

205

Reset Content

The server has successfully processed the request, but does not return any content. Unlike a 204 response, this response requires that the requester reset the content.

206

Partial Content

The server has successfully processed a part of the GET request.

300

Multiple Choices

There are multiple options for the requested resource. For example, this code could be used to present a list of resource characteristics and addresses from which the client such as a browser may choose.

301

Moved Permanently

This and all future requests should be permanently directed to the given URI indicated in this response.

302

Found

The requested resource was temporarily moved.

303

See Other

The response to the request can be found under another URI using a GET or POST method.

304

Not Modified

The requested resource has not been modified. In such a case, there is no need to retransmit the resource since the client still has a previously-downloaded copy.

305

Use Proxy

The requested resource is available only through a proxy.

306

Unused

This HTTP status code is no longer used.

400

BadRequest

The request is invalid.

The client should modify the request instead of re-initiating it.

401

Unauthorized

The authentication information provided by the client is incorrect or invalid.

402

Payment Required

Reserved for future use.

403

Forbidden

The server has received the request and understood it, but the server is refusing to respond to it.

The client should modify the request instead of re-initiating it.

404

NotFound

The requested resource could not be found.

The client should modify the request instead of re-initiating it.

405

MethodNotAllowed

A request method is not supported for the requested resource.

The client should modify the request instead of re-initiating it.

406

Not Acceptable

The server could not fulfill the request according to the content characteristics of the request.

407

Proxy Authentication Required

This code is similar to 401, but indicates that the client must first authenticate itself with the proxy.

408

Request Time-out

The server timed out waiting for the request.

The client may re-initiate the request without modifications at any later time.

409

Conflict

The request could not be processed due to a conflict in the request.

For example, an edit conflict between multiple simultaneous updates or the resource that the client attempts to create already exists.

410

Gone

The requested resource has been deleted permanently and will not be available again.

The status code indicates that the requested resource has been deleted permanently.

411

Length Required

The server refused to process the request because the request does not specify the length of its content.

412

Precondition Failed

The server does not meet one of the preconditions that the requester puts on the request.

413

Request Entity Too Large

The request is larger than the server is willing or able to process. The server may close the connection to prevent the client from continuing the request. If the server temporarily cannot process the request, the response will contain a Retry-After header field.

414

Request-URI Too Large

The URI provided was too long for the server to process.

415

Unsupported Media Type

The server does not support the media type in the request.

416

Requested range not satisfiable

The requested range is invalid.

417

Expectation Failed

The server fails to meet the requirements of the Expect request-header field.

422

UnprocessableEntity

The request was well-formed but was unable to be followed due to semantic errors.

429

TooManyRequests

The client has sent more requests than its rate limit is allowed within a given amount of time, or the server has received more requests than it is able to process within a given amount of time. In this case, it is advisable for the client to re-initiate requests after the time specified in the Retry-After header of the response expires.

441

Authentication Error

Authentication fails.

500

InternalServerError

The server is able to receive the request but it could not understand the request.

501

Not Implemented

The server does not support the requested function.

502

Bad Gateway

The server was acting as a gateway or proxy and received an invalid request from a remote server.

503

ServiceUnavailable

The requested service is invalid.

The client should modify the request instead of re-initiating it.

504

ServerTimeout

The server could not return a timely response. The response will reach the client only if the request carries a timeout parameter.

505

HTTP Version not supported

The server does not support the HTTP protocol version used in the request.