Docs / Quickstart

Quickstart

1. Site key

# The site key is issued per location, not per operator.
# It only grants access to that location's streams.

export NORDVIK_SITE_KEY="nv_site_4f21ac8e"

2. Register the site

The identifier is yours to choose and appears in every feed path afterwards, so pick something you will still recognise in two years.

curl -X POST https://<endpoint>/api/v1/plants \
  -H "Authorization: Bearer $NORDVIK_SITE_KEY" \
  -d "id=gdansk-dc2" \
  -d "name=Gdansk DC-2" \
  -d "timezone=Europe/Warsaw"

3. Attach a camera

curl -X POST https://<endpoint>/api/v1/plants/gdansk-dc2/streams \
  -H "Authorization: Bearer $NORDVIK_SITE_KEY" \
  -d "id=gate-a" \
  -d "label=Gate A - inbound" \
  -d "retention_days=180"

4. Start a session

# Open a session and start moving segments.
# Full protocol: /docs/streams

curl -X POST https://<endpoint>/api/v1/plants/session \
  -H "Authorization: Bearer $NORDVIK_SITE_KEY" \
  -d "plant=gdansk-dc2" -d "stream=gate-a"