kulturkurier Developer Documentation
Endpoints
The API endpoints are at https://api.kulturkurier.de
.
Response and Request Payload Format
The data is sent and received as UTF-8 encoded JSON.
For XML responses just add add Content-Type: application/xml
to the request header.
Request payloads can only be sent as JSON.
Errors
- Sending invalid JSON will result in a
400 Bad Request
response. - Sending invalid fields will result in a
422 Unprocessable Entity
or in a409 Conflict
response. - Calling a endpoint or an entity which does not exist will result in a
404 Not Found
response.
Pagination
Pagination can be performed using page
and limit
parameters. The default limit for all endpoints is 25. Page starts at 1.
Example request to receive the first 50 event show items:
https://api.kulturkurier.de/event-show/?page=1&limit=50
Data Formats
Data type | Description |
---|---|
String | Strings with a max length of 255 characters |
Text | Strings with a max length of 64 KB |
Url | Validated URLs with a max length of 255 characters |
Integer | 4 bytes integer |
Date | Single dates represented in the format YYYY-MM-DD |
DateTime | DateTimes represented as ISO 8601 string, i.e. in the format YYYY-MM-DDTHH:MM:SSZ |
Time | A single time represented as an integer from 0 to 2359, e.g 0 means 0 am, 1442 means 2.42 pm |
Country | Three-digit country code according to ISO 3166-1 alpha-3, e.g. DEU, ITA |