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
| Status | Meaning |
|---|---|
| 200 | Successful request, including searches with no matches. |
| 204 | Successful OPTIONS request; no response body. |
| 400 | Invalid or unsupported query parameter. |
| 401 | Missing or incorrect Music Library API key. |
| 404 | Endpoint not found. |
| 405 | Method not supported. |
| 500 | Server error. Always returned by the error endpoint below. |
Error response
application/json. A flat object with one field:
| Field | Type | Description |
|---|---|---|
error | string | Description of the error. |
Error endpoint
GET https://api.mydcts.org/error
Returns 500 for every valid GET request. Accepts the optional delay parameter.