Media-APIAPI

Eén keer uploaden, overal publiceren

Stuur een bestand naar de mediabibliotheek en krijg een id terug. Koppel dat id aan zoveel posts als je wilt en FoPost zet het om en levert het in de vorm die elk netwerk wil. Opslag is privé en beperkt tot de werkruimte.

Haal je API-sleutel op Lees de documentatie

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

Afbeeldingen en video tot 50 MB, gecontroleerd op inhoud en niet alleen op extensie.

Hergebruik via id

Eén upload, zoveel posts als je wilt. Het bestand wordt nooit twee keer verzonden.

Standaard privé

Bestanden staan in privéopslag en worden alleen aan leden van de werkruimte getoond.

Uploaden

Eén weg naar binnen, gecontroleerd bij aankomst

Elk bestand volgt hetzelfde pad: MIME-allowlist, controle van de echte bytes, een maximale grootte en de gratis opslagruimte van je account. Wat terugkomt is een bibliotheekrij met type en grootte, klaar om te koppelen.

Media-documentatie lezen

Aan een post koppelen

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

Afbeeldingen

PNG, JPEG, GIF en WebP, met type en grootte uitgelezen bij het uploaden.

Video

MP4 en MOV, met duur en grootte gecontroleerd per netwerk op het moment van publiceren.

Gecontroleerd

De echte inhoud van het bestand moet bij het type passen, anders wordt de upload geweigerd.

Leveren

Het juiste formaat voor elk netwerk, zonder dat jij er iets voor doet

Netwerken zijn het oneens over beeldverhoudingen, formaten en codecs. Bij het publiceren neemt elke adapter het opgeslagen origineel en uploadt wat dat platform accepteert, zodat één item uit de bibliotheek werkt in een carrousel, een thread en een feed met korte video's.

Zien hoe aflevering werkt

Merkafbeeldingen geordend in de gedeelde mediabibliotheek

Regels per netwerk

Limieten voor grootte en formaat worden door de adapter toegepast, niet door jou.

Geordende media

De volgorde in het contentblok is de volgorde van de carrousel.

Duidelijke fouten

Een bestand dat een netwerk niet aanneemt, laat die aflevering mislukken met de reden, niet de hele post.

Beheren

Blader door de bibliotheek, haal op en hergebruik

Bekijk de bibliotheek met filters, haal elk item op via een bestands-endpoint dat bij elk verzoek het lidmaatschap van de werkruimte controleert en nooit verloopt, en gebruik hetzelfde id in zoveel posts als je wilt. Merkassets, imports en gegenereerde afbeeldingen komen allemaal in dezelfde bibliotheek terecht.

Begin met bouwen

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

Opvragen en filteren

Op type, herkomst of merkrol, met paginering.

Stabiele bestands-URL

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

Per werkruimte

Een sleutel ziet de bibliotheek van één werkruimte en verder niets.

Vragen over Media-API, beantwoord

Wat is de maximale grootte?

50 MB per bestand. Netwerken hebben hun eigen limieten, en die worden gecontroleerd wanneer een post aan dat netwerk wordt geleverd.

Welke formaten worden geaccepteerd?

Gangbare afbeeldingsformaten (PNG, JPEG, GIF, WebP) en video (MP4, MOV). De upload controleert de echte bytes van het bestand, dus een hernoemd bestand wordt geweigerd.

Kan ik een media-id aan meer dan één post koppelen?

Ja. Daar is de bibliotheek voor. Upload één keer en gebruik het id in elke post in de werkruimte.

Zijn geüploade bestanden openbaar?

Nee. Opslag is privé. Het bestands-endpoint controleert bij elk verzoek het lidmaatschap van de werkruimte, en netwerken krijgen alleen bij het publiceren een link die snel verloopt.

Telt het mee voor een limiet?

Ja, elk account bevat gratis opslagruimte, en opslag daarboven wordt met een opgeslagen kaart per GB per maand afgerekend. Elke upload, import en gegenereerde afbeelding telt op dezelfde manier mee.

Kan ik importeren vanaf een URL of ontwerptool?

Ja, imports komen in dezelfde bibliotheek terecht en bevatten een bronverwijzing, zodat je een bijgewerkt ontwerp ter plekke opnieuw kunt ophalen in plaats van een nieuw bestand te uploaden.

Bouw vandaag nog op de Media-API

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op