Getting Started

Authentication

One header on every request. There is no login call, no token exchange, no refresh step and no request signing.

The header

X-Api-Key: pk_live_example_0000000000000000
Content-Type: application/json

Send your API key directly on each call and you are authenticated.

Complete example

curl -X POST https://api.spectatr.ai/partner/v1/matches/g-88213/ingest \
  -H "X-Api-Key: pk_live_example_0000000000000000" \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "SRT_CALLER",
    "url": "srt://feed.provider.example:9001",
    "ingestStartTime": 1757008800000,
    "latencyMs": 200
  }'

Rotation and revocation

Two keys can be active at once. To rotate, we issue a new key while the existing one keeps working; you cut over at your own pace, then tell us to revoke the old one, with no downtime and no coordinated deploy. Tell us straight away if a key is exposed and we will revoke it and issue a replacement.