REST-API Quickstart

Einstieg in die footage.one REST-API — von der Discovery am Root-Endpoint bis zur ersten Suche.

Root-Endpoint

Jeder Aufruf beginnt sinnvollerweise hier:

curl https://app.footage.one/api/asset/

Die Antwort listet alle verfügbaren Resourcen über das _links-Objekt — siehe HATEOAS verstehen. Damit ist die API auch ohne Spec-Datei navigierbar.

Auth

Die meisten Endpoints sind token-pflichtig. Token aus https://app.footage.one/account per apiKey-Header senden (kein Bearer-Prefix):

curl -H "apiKey: DEIN_API_TOKEN" https://app.footage.one/api/asset/albums

Public-Endpoints (/public/*, /configuration/archive, Root) funktionieren auch ohne Token. Details siehe API-Tokens.

Beispiele

Asset suchen

curl -H "apiKey: DEIN_API_TOKEN" \
  "https://app.footage.one/api/asset/search/assets?query=berlin&limit=5"

Asset-Detail

curl -H "apiKey: DEIN_API_TOKEN" \
  https://app.footage.one/api/asset/assets/asset-id-123

Album anlegen

curl -X POST \
  -H "apiKey: DEIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Reisen 2026"}' \
  https://app.footage.one/api/asset/albums

Pagination

Listing-Endpoints unterstützen offset und limit als Query-Parameter:

GET /api/asset/albums?offset=20&limit=10

Maximum limit: 100. Default: 20.

Spec / Swagger UI

Interaktive Doku: https://app.footage.one/api/asset/swagger-ui.html

Weiter

Zapier / Make HATEOAS