Entwickler-Ressourcen

Alle Schnittstellen, Specs und Guides auf einer Seite. API und MCP sind in allen Plänen freigeschaltet, auch im Free-Tier.

Eine URL genügt zum Einstieg

Die gesamte API ist über HATEOAS-Links ab einer einzigen URL erkundbar. Du kannst direkt loslegen, eine Spec-Datei brauchst du dafür nicht.

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

Antwort enthält _links zu allen Resources sowie einen documentation-Link zur Swagger UI.

API-Referenz

Maschinenlesbare und interaktive API-Dokumentation.

Interaktive REST-API-Dokumentation mit Try-It-Out.

API-Root (HATEOAS)

Einstiegspunkt — alle Endpoints über _links erkundbar.

Maschinenlesbares Verzeichnis aller footage.one-APIs.

REST-API Quickstart

curl-Beispiele, Auth, Pagination — direkt loslegen.

MCP-Server

Model Context Protocol für Claude Desktop, n8n und LangChain — Endpoint, Auth und Tool-Liste in der Doku.

MCP-Endpoint Doku

https://mcp.footage.one/mcp — Streamable HTTP. Setup-Schritte und Auth-Details.

Maschinenlesbare Beschreibung des MCP-Servers.

KI-orientierte Übersicht der Plattform.

Auth

Persönlicher API-Token für REST oder OAuth2 mit PKCE für Drittapps.

Account / API-Token

Persönlichen API-Token im Asset-Manager generieren.

API-Tokens — Doku

Token erstellen, verwenden, Public-Endpoints abgrenzen.

OAuth2 für Drittapps

PKCE-Flow für Multi-User-Apps und Custom GPTs.

Maschinenlesbare Endpoint-Liste vom Keycloak (Realm footageone).

Integrationen

Setup-Anleitungen für Claude Desktop, n8n, LangChain, Custom GPTs, Zapier und Make.

MCP-Server in Claude Desktop einbinden.

MCP Client Tool Node für Workflow-Automation.

LangChain & LangGraph

Python und JavaScript SDK-Snippets.

OpenAI Custom GPT

OpenAPI Actions mit OAuth2.

Zapier / Make.com

No-Code-Automation via REST.

Agentic Cookbook

Fünf erprobte Prompt-Patterns für gängige Aufgaben.

Standards

footage.one setzt durchgehend auf offene Standards.

OpenAPI / Swagger

API-Spec in standardisiertem Format.

MCP — Model Context Protocol

Spec auf modelcontextprotocol.io.

HATEOAS / HAL+JSON

Hypermedia-driven REST — Discovery via _links.

Authorization Code Flow mit PKCE.

Architektur-Hinweis

Die Haupt-API für Integrationen ist /api/asset/ (REST mit HATEOAS). Daneben existiert ein interner GraphQL-Service für die Such-Komponente (apps/ork) — der ist nicht für externe Integration gedacht. Für Agenten und Drittapps immer die asset-API verwenden.

[email protected]