Medien-APIAPI

Einmal hochladen, überall veröffentlichen

Sende eine Datei an die Medienbibliothek und erhalte eine ID. Hänge diese ID an beliebig viele Beiträge an, und FoPost wandelt die Datei um und liefert sie in der Form, die jedes Netzwerk verlangt. Der Speicher ist privat und auf den Workspace begrenzt.

API-Schlüssel holenDoku lesen
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

Multipart-Upload

Bilder und Videos bis 50 MB, geprüft anhand des Inhalts, nicht nur der Endung.

Wiederverwendung per ID

Ein Upload, beliebig viele Beiträge. Die Datei wird nie zweimal gesendet.

Standardmäßig privat

Dateien liegen in privatem Speicher und werden nur an Workspace-Mitglieder ausgeliefert.

Hochladen

Ein einziger Weg hinein, geprüft bei der Ankunft

Jede Datei durchläuft denselben Weg: MIME-Allowlist, Prüfung der tatsächlichen Bytes, eine Größenobergrenze und das kostenlose Speicherkontingent deines Kontos. Zurück kommt ein Bibliothekseintrag mit Typ und Größe, bereit zum Anhängen.

Medien-Referenz lesen
An einen Beitrag anhängen
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

Bilder

PNG, JPEG, GIF und WebP, Typ und Größe werden beim Upload ausgelesen.

Video

MP4 und MOV, Dauer und Größe werden beim Veröffentlichen für jedes Netzwerk geprüft.

Validiert

Der tatsächliche Inhalt der Datei muss zu ihrem Typ passen, sonst wird der Upload abgelehnt.

Ausliefern

Das richtige Format für jedes Netzwerk, automatisch

Netzwerke sind sich bei Seitenverhältnissen, Größen und Codecs uneinig. Beim Veröffentlichen nimmt jeder Adapter das gespeicherte Original und lädt hoch, was die Plattform akzeptiert, sodass ein einziges Bibliotheks-Asset in einem Karussell, einem Thread und einem Kurzvideo-Feed gleichermaßen funktioniert.

So funktioniert die Auslieferung
Markenbilder, organisiert in der gemeinsamen Medienbibliothek

Regeln pro Netzwerk

Größen- und Formatlimits wendet der Adapter an, nicht du.

Medien in Reihenfolge

Die Reihenfolge im Inhaltsblock ist die Reihenfolge des Karussells.

Eindeutige Fehler

Eine Datei, die ein Netzwerk nicht annimmt, lässt nur diese Zustellung mit Angabe des Grundes scheitern, nicht den ganzen Beitrag.

Verwalten

Bibliothek durchsuchen, abrufen und wiederverwenden

Liste die Bibliothek mit Filtern auf, rufe jedes Asset über einen Datei-Endpunkt ab, der bei jeder Anfrage die Workspace-Mitgliedschaft prüft und nie abläuft, und verweise von beliebig vielen Beiträgen auf dieselbe ID. Marken-Assets, Importe und generierte Bilder landen alle in derselben Bibliothek.

Jetzt bauen
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

Auflisten und filtern

Nach Typ, Herkunft oder Markenrolle, mit Paginierung.

Stabile Datei-URL

/v1/media/:id/file always works for members; no signed links to refresh.

Auf den Workspace begrenzt

Ein Schlüssel sieht die Bibliothek eines Workspaces und sonst nichts.

Fragen zu Medien-API, beantwortet

Wie hoch ist das Größenlimit?

50 MB pro Datei. Einzelne Netzwerke haben eigene Obergrenzen, die geprüft werden, wenn ein Beitrag an das jeweilige Netzwerk zugestellt wird.

Welche Formate werden akzeptiert?

Gängige Bildformate (PNG, JPEG, GIF, WebP) und Videoformate (MP4, MOV). Der Upload prüft die tatsächlichen Datei-Bytes, eine umbenannte Datei wird also abgelehnt.

Kann ich eine Medien-ID an mehr als einen Beitrag anhängen?

Ja. Genau dafür ist die Bibliothek da. Einmal hochladen und von jedem Beitrag im Workspace auf die ID verweisen.

Sind hochgeladene Dateien öffentlich?

Nein. Der Speicher ist privat. Der Datei-Endpunkt prüft bei jeder Anfrage die Workspace-Mitgliedschaft, und Netzwerke erhalten nur beim Veröffentlichen einen kurzlebigen Link.

Wird das auf ein Kontingent angerechnet?

Ja, jedes Konto enthält ein kostenloses Speicherkontingent, und Speicher darüber hinaus wird mit hinterlegter Karte pro GB und Monat abgerechnet. Jeder Upload, jeder Import und jedes generierte Bild zählt gleichermaßen dazu.

Kann ich von einer URL oder aus einem Design-Tool importieren?

Ja, Importe landen in derselben Bibliothek und tragen einen Quellverweis, sodass du ein aktualisiertes Design direkt neu abrufen kannst, statt eine neue Datei hochzuladen.

Baue noch heute auf Medien-API

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen