REST-API v1: Videos aus dem eigenen Code planen

Q: Wie vermeide ich doppelte Beiträge nach einer Zeitüberschreitung?

Senden Sie einen Idempotency-Key -Header. Eine wiederholte Anfrage mit demselben Schlüssel innerhalb von 24 Stunden liefert den ersten Beitrag statt eines neuen.

Was es kann

Beiträge: POST /v1/posts mit JSON (Medien als URLs) oder Multipart (Medien als Dateien). Sofort veröffentlichen oder mit scheduled_at und timezone planen.
Status: einen Beitrag mit Status pro Plattform, Beitragsadresse, Versuchen und Hinweisen lesen. Geplante Beiträge absagen oder verschieben.
Profile und Konten: Profile mit verbundenen Konten abrufen und Verbindungslinks für Ihre Kunden erzeugen.
Nutzung: aktueller Plan, Grenzen und Uploads im Monat (GET /v1/me, GET /v1/usage).
Überall dieselben Optionen: Plattformfelder heißen wie in der Upload-Post-kompatiblen API (youtube_title, privacy_level, pinterest_board_id …).
Sicherheitsnetze: Idempotency-Key gegen doppelte Beiträge, Rate-Limit-Header, klare Fehlercodes.
OpenAPI: maschinenlesbar unter /openapi.json, lesbar unter /docs/api.

Beispiel:

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"}'

Grenzen

Anfragen pro Minute hängen vom Plan ab (30 im Test bis 600 bei Agency); die Header X-RateLimit-* zeigen den Stand.
Uploads pro Monat und die Zahl der API-Schlüssel hängen vom Plan ab. 1 Upload = 1 Beitrag auf 1 Konto.
Dateigröße: bis zum Maximum Ihres Plans (500 MB im Test, bis 4 GB).
Medien-URLs müssen öffentliche https-Adressen sein; Adressen aus privaten Netzen lehnen wir ab.
Die Regeln der einzelnen Plattformen gelten weiter – siehe die Plattformseiten.

Einrichtung

Öffnen Sie in der App API & Webhooks und klicken Sie auf Neuer Schlüssel. Kopieren Sie den Schlüssel – er wird nur einmal angezeigt.
Senden Sie ihn im Header Authorization: Bearer <Schlüssel> (oder Apikey <Schlüssel>).
Testen Sie ihn mit GET /v1/me.
Legen Sie mit POST /v1/posts den ersten Beitrag an.
Optional: einen Webhook anlegen, damit Sie Ergebnisse ohne Abfragen erhalten.

Details: API und Schlüssel, Webhooks.

Häufige Fragen

REST-API v1 oder Upload-Post-kompatible API?

Beide nutzen denselben Schlüssel und denselben Kern. Für neue Projekte nehmen Sie v1; haben Sie schon Upload-Post-Code, nehmen Sie die kompatible API.

Wie vermeide ich doppelte Beiträge nach einer Zeitüberschreitung?

Senden Sie einen Idempotency-Key-Header. Eine wiederholte Anfrage mit demselben Schlüssel innerhalb von 24 Stunden liefert den ersten Beitrag statt eines neuen.

Gibt es ein SDK?

Noch nicht. Die OpenAPI-Datei funktioniert mit gängigen Code-Generatoren.

REST-API v1