Skip to main content

Usage

Listing recordings​

You can list recordings using the /recordings/:event endpoint. For example, you can use curl to list all recordings for an event:

curl --request GET http://localhost:10700/recordings/0f339cb0-7ab4-43fe-852d-75708232f76c

Uploading and downloading recordings​

You can upload and download recordings using the /recordings/:event/:start endpoint. To upload a recording, you can use curl to send a PUT request streaming the content from a file:

curl \
    --request PUT \
    --header "Content-Type: audio/ogg" \
    --header "Transfer-Encoding: chunked" \
    --upload-file recording.ogg \
    http://localhost:10700/recordings/0f339cb0-7ab4-43fe-852d-75708232f76c/2024-01-01T00:00:00

To download a recording, you can use curl to send a GET request and save the response body to a file:

curl --request GET --output recording.ogg http://localhost:10700/recordings/0f339cb0-7ab4-43fe-852d-75708232f76c/2024-01-01T00:00:00

Deleting recordings​

You can delete recordings using the /recordings/:event/:start endpoint. For example, you can use curl to delete a recording:

curl --request DELETE http://localhost:10700/recordings/0f339cb0-7ab4-43fe-852d-75708232f76c/2024-01-01T00:00:00

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:10700/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:10700/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:10700/openapi/openapi.json