Webhooks

Live feed (SSE)

A Server-Sent Events stream of your stream-play events in real time, across all your streams, the push alternative to polling now-playing. This is the low-latency feed: it fires the moment a track is detected, so unlike webhooks it is not settled first and a detection can occasionally resolve differently a moment later. Use it to drive a live now-playing display, and webhooks for the confirmed log. Each message is an SSE event: line (stream.play.started) with the event JSON in data:. Authenticate with the x-api-key header; in the browser, proxy this through your own server so the key isn't exposed (the EventSource API can't send headers). Bundled with stream monitoring (no API credits).

get/v1/streams/live

Request

  • Base URL: https://api.sonovault.now
  • URL: https://api.sonovault.now/v1/streams/live
  • Auth: API key in header x-api-key

Response

Successful response

idstring required

Event ID. Stable across webhook retries; dedupe on it.

type'stream.play.started' | 'stream.offline' | 'stream.online' required

Event type. The data payload differs per type.

createdstring required

When the event was emitted, ISO-8601 UTC.

Changes

No recorded changes to this operation across all 1 revision of this API.