API und API-Schlüssel

API-Schlüssel anlegen, mit Bearer oder Apikey anmelden, über REST-API v1 oder die Upload-Post-kompatible API veröffentlichen, Limits und Idempotency-Key.

Video Automation hat zwei Schnittstellen mit einem gemeinsamen Schlüssel:

• REST-API v1 – JSON, ressourcenorientiert, für neue Projekte.
• Upload-Post-kompatible API – dieselben Pfade, Felder und Antworten wie Upload-Post. Bestehende Skripte, n8n-Workflows und Make-Szenarien laufen weiter.

Basis-URL: https://my-video-automation.com. Vollständige Referenz: /docs/api, maschinenlesbar: /openapi.json.

Schlüssel anlegen

1. Öffnen Sie im Dashboard API & Webhooks.
2. Klicken Sie auf Neuer Schlüssel, vergeben Sie einen Namen (zum Beispiel n8n) und klicken Sie auf Anlegen.
3. Kopieren Sie den Schlüssel sofort – er wird nur einmal angezeigt. Wir speichern nur einen Hash.

Wie viele Schlüssel möglich sind, hängt von Ihrem Plan ab. Mit Widerrufen sperren Sie einen Schlüssel; Skripte damit funktionieren sofort nicht mehr. Zum Anlegen braucht es die Berechtigung „API: verwalten“ (standardmäßig Inhaber und Administrator).

Anmelden

Senden Sie den Schlüssel im Header Authorization. Beide Schreibweisen funktionieren für beide Schnittstellen:

Authorization: Bearer IHR_SCHLUESSEL
Authorization: Apikey IHR_SCHLUESSEL

Einen Schlüssel prüfen Sie mit GET /api/uploadposts/me oder GET /v1/me.

REST-API v1: Video veröffentlichen

curl https://my-video-automation.com/v1/posts \
  -H "Authorization: Bearer IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": "meine-marke",
    "platforms": ["youtube", "bluesky"],
    "title": "Mein Video",
    "media_urls": ["https://example.com/clip.mp4"],
    "scheduled_at": "2026-12-01T12:00:00",
    "timezone": "Europe/Berlin"
  }'

Die Antwort ist der Beitrag mit einem Status je Plattform. Optionen haben dieselben Feldnamen wie in der Upload-Post-API (zum Beispiel privacyStatus, tags, bluesky_alt_text). Dateien können Sie auch als Multipart-Feld media senden.

Upload-Post-kompatibel: Video veröffentlichen

curl -X POST https://my-video-automation.com/api/upload \
  -H "Authorization: Apikey IHR_SCHLUESSEL" \
  -F "user=meine-marke" \
  -F "platform[]=youtube" -F "platform[]=bluesky" \
  -F "title=Mein Video" \
  -F "video=@clip.mp4" \
  -F "scheduled_date=2026-12-01T12:00:00" \
  -F "timezone=Europe/Berlin"

• Ohne scheduled_date wartet die Anfrage bis etwa eine Minute auf das Ergebnis; längere Uploads laufen im Hintergrund weiter und liefern eine request_id.
• async_upload=true antwortet sofort mit einer request_id.
• Den Status fragen Sie mit GET /api/uploadposts/status?request_id=… oder ?job_id=… ab.

Fotos gehen an /api/upload_photos (photos[]), Textbeiträge an /api/upload_text. Welche Plattform was unterstützt, steht auf den Integrationsseiten.

Anfrage-Limits

Anfragen pro Minute und Schlüssel hängen vom Plan ab:

Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Über dem Limit erhalten Sie HTTP 429 mit retry_after in Sekunden – kurz warten und erneut senden.

Doppelte Beiträge vermeiden

Senden Sie einen Header Idempotency-Key (eine eindeutige Zeichenkette, zum Beispiel Ihre eigene ID des Videos). Kommt derselbe Schlüssel innerhalb von 24 Stunden erneut, liefern wir den ursprünglichen Beitrag zurück, statt doppelt zu veröffentlichen. Das hilft, wenn ein Workflow-Werkzeug eine Anfrage nach einer Zeitüberschreitung wiederholt.

Mit request_id (6–64 Zeichen) wählen Sie die ID selbst, mit external_id versehen Sie Beiträge mit Ihrer eigenen Referenz; der Verlauf lässt sich danach filtern.

Fehler

Fehler kommen als JSON mit error (maschinenlesbarer Code) und message. Typische Fälle:

• 401 – Schlüssel fehlt, ist falsch oder widerrufen.
• 400 – ein Feld fehlt oder ist ungültig, etwa user_required oder invalid_platform.
• 402 – der Test ist abgelaufen oder der Arbeitsbereich hat keinen aktiven Plan.
• 429 – Anfrage-Limit oder monatliches Upload-Kontingent erreicht.

Ergebnisse je Plattform enthalten success, url oder error und error_code. Über das Ergebnis informieren Sie Webhooks.

Automatisierungs-Werkzeuge

n8n, Make und Zapier arbeiten mit einfachen HTTP-Anfragen – siehe die Seiten zu n8n, Make und Zapier.