Request behavior

Shared behavior for all endpoints.

Requests

GET returns data. HEAD returns headers only. OPTIONS returns 204. Write methods are not supported. Cross-origin requests are allowed from any origin.

Query parameters must be single values. Unknown parameters and invalid values return 400. All endpoints accept an optional delay parameter: an integer from 0 to 2000 milliseconds, default 0.

Status codes

StatusMeaning
200Successful request, including searches with no matches.
204Successful OPTIONS request; no response body.
400Invalid or unsupported query parameter.
401Missing or incorrect Music Library API key.
404Endpoint not found.
405Method not supported.
500Server error. Always returned by the error endpoint below.

Error response

application/json. A flat object with one field:

FieldTypeDescription
errorstringDescription of the error.

Error endpoint

GET https://api.mydcts.org/error

Returns 500 for every valid GET request. Accepts the optional delay parameter.