REST API Quickstart

Pierwsze kroki z REST API footage.one — od discovery na endpoincie głównym do pierwszego wyszukiwania.

Endpoint główny

Każde wywołanie sensownie zaczyna się tutaj:

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

Odpowiedź wyświetla wszystkie dostępne zasoby przez obiekt _links — zob. Zrozumieć HATEOAS. Dzięki temu API jest nawigowalne nawet bez pliku spec.

Uwierzytelnianie

Większość endpointów wymaga tokena. Wyślij token z https://app.footage.one/account przez nagłówek apiKey (bez prefiksu Bearer):

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

Publiczne endpointy (/public/*, /configuration/archive, główny) działają też bez tokena. Szczegóły znajdziesz w artykule Tokeny API.

Przykłady

Wyszukiwanie zasobów

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

Szczegóły zasobu

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

Tworzenie albumu

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

Paginacja

Endpointy listujące obsługują offset i limit jako parametry zapytania:

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

Maksymalny limit: 100. Domyślnie: 20.

Spec / Swagger UI

Interaktywna dokumentacja: https://app.footage.one/api/asset/swagger-ui.html

Następne kroki

Zapier / Make HATEOAS