API mediaAPI

Carica una volta, pubblica ovunque

Invia un file alla libreria multimediale e ricevi un id. Allega quell'id a tutti i post che vuoi e FoPost lo converte e lo consegna nel formato richiesto da ogni rete. L'archiviazione è privata e limitata al workspace.

Ottieni la tua chiave API Leggi la documentazione

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
    }
  ]
}

Caricamento multipart

Immagini e video fino a 50 MB, convalidati in base al contenuto, non solo all'estensione.

Riutilizzo tramite id

Un caricamento, tutti i post che vuoi. Il file non viene mai inviato due volte.

Privato per impostazione predefinita

I file sono in un archivio privato e vengono serviti solo ai membri del workspace.

Caricamento

Un solo ingresso, con controllo all'arrivo

Ogni file segue lo stesso percorso: allowlist MIME, controllo dei byte effettivi, limite di dimensione e spazio di archiviazione gratuito del tuo account. Ottieni una riga della libreria con tipo e dimensione, pronta da allegare.

Leggi il riferimento media

Allega a un post

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

Immagini

PNG, JPEG, GIF e WebP, con tipo e dimensione letti al caricamento.

Video

MP4 e MOV, con durata e dimensione verificate per ogni rete al momento della pubblicazione.

Convalidato

Il contenuto reale del file deve corrispondere al suo tipo, altrimenti il caricamento viene rifiutato.

Consegna

Il formato giusto per ogni rete, senza pensarci

Le reti non concordano su proporzioni, dimensioni e codec. Al momento della pubblicazione, ogni adapter prende l'originale salvato e carica ciò che quella piattaforma accetta, così un singolo asset della libreria funziona su un carosello, un thread e un feed di video brevi.

Vedi come funziona la consegna

Regole per rete

I limiti di dimensione e formato sono applicati dall'adapter, non da te.

Media ordinati

L'ordine nel blocco di contenuto è l'ordine del carosello.

Errori chiari

Un file che una rete non accetta fa fallire quella consegna con il motivo, non l'intero post.

Gestisci

Sfoglia, recupera e riutilizza la libreria

Elenca la libreria con i filtri, recupera qualsiasi asset tramite un endpoint per i file che verifica l'appartenenza al workspace a ogni richiesta e non scade mai, e usa lo stesso id in tutti i post che vuoi. Asset del brand, importazioni e immagini generate finiscono tutti nella stessa libreria.

Inizia a sviluppare

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

Elenca e filtra

Per tipo, origine o ruolo nel brand, con paginazione.

URL del file stabile

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

Limitato al workspace

Una chiave vede la libreria di un solo workspace e nient'altro.

API media: le risposte alle tue domande

Qual è il limite di dimensione?

50 MB per file. Le singole reti hanno i propri limiti, che vengono verificati quando un post viene consegnato a quella rete.

Quali formati sono accettati?

I formati immagine più comuni (PNG, JPEG, GIF, WebP) e video (MP4, MOV). Il caricamento controlla i byte effettivi del file, quindi un file rinominato viene rifiutato.

Posso allegare un id media a più di un post?

Sì, è proprio lo scopo della libreria. Carica una volta e usa l'id in qualsiasi post del workspace.

I file caricati sono pubblici?

No. L'archiviazione è privata. L'endpoint per i file verifica l'appartenenza al workspace a ogni richiesta, e le reti ricevono un link a breve scadenza solo al momento della pubblicazione.

Conta nella quota?

Sì, ogni account include uno spazio di archiviazione gratuito, e oltre quel limite lo spazio viene conteggiato per GB al mese con una carta registrata. Ogni caricamento, importazione e immagine generata conta allo stesso modo.

Posso importare da un URL o da uno strumento di design?

Sì, le importazioni arrivano nella stessa libreria e mantengono un riferimento alla fonte, così puoi recuperare un design aggiornato sul posto invece di caricare un nuovo file.

Sviluppa oggi con API media

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API