Skip to main content

Usage

Managing shows and events​

You can manage shows and events using the /shows and /events endpoints. The API follows RESTful conventions, so you can use the following HTTP methods:

  • GET to retrieve a resource or a list of resources
  • POST to create a new resource
  • PATCH to update an existing resource
  • DELETE to delete an existing resource

For example, to create a new show, you can use curl to send a POST request to the /shows endpoint:

curl \
    --request POST \
    --header "Content-Type: application/json" \
    --data '{"title": "My Show"}' \
    http://localhost:10500/shows

Retrieving the schedule​

Events themselves only contain the information about start and end times of the first instance and the recurrence rule. To make it easier to retrieve event instances for a given time range, there is a /schedule endpoint. It expands the recurrence rule into event instances in the given time range.

For example, to retrieve the schedule for a given week, you can use curl to send a GET request to the /schedule endpoint:

curl \
    --get \
    --request GET \
    --header "Content-Type: application/json" \
    --data-urlencode "start=2024-01-01T00:00:00" \
    --data-urlencode "end=2024-01-08T00:00:00" \
    http://localhost:10500/schedule

The start and end times should be in the UTC timezone.

Ping​

You can check the status of the service by sending either a GET or HEAD request to the /ping endpoint. The service should respond with a 204 No Content status code.

For example, you can use curl to do that:

curl --request HEAD --head http://localhost:10500/ping

Server-Sent Events​

You can subscribe to Server-Sent Events (SSE) by sending a GET request to the /sse endpoint. The service should send you the events as they happen.

For example, you can use curl to do that:

curl --request GET --no-buffer http://localhost:10500/sse

OpenAPI​

You can view the OpenAPI documentation made with Scalar by navigating to the /openapi endpoint in your browser.

You can also download the specification in JSON format by sending a GET request to the /openapi/openapi.json endpoint.

For example, you can use curl to do that:

curl --request GET http://localhost:10500/openapi/openapi.json