API di pubblicazioneAPI

Un solo POST per pubblicare ovunque

Crea un post una volta, elenca gli account da raggiungere e FoPost gestisce formattazione, caricamento dei media e consegna per ogni rete. Chiavi con scope, richieste idempotenti e stato di consegna che puoi interrogare o ricevere via webhook.

Ottieni la tua chiave APILeggi la documentazione
POST /v1/posts
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": "Shipped a new release today." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
  -H "X-API-Key: $API_KEY"

Tutte le reti, un solo formato

Lo stesso corpo della richiesta pubblica su X, LinkedIn, Instagram e tutti gli altri account collegati.

Chiavi con scope

Una chiave con lo scope publish può pubblicare e nient'altro. Revocala senza toccare le altre.

Consegna per account

Ogni account riporta il proprio stato, l'id esterno e il permalink appena il post è online.

Pubblica

Scrivi il post una volta, scegli qualsiasi gruppo di account

Passa il testo, i media e gli account da raggiungere. FoPost applica i limiti e le convenzioni di ogni rete, carica i media nel formato richiesto dalla piattaforma e restituisce un id del post da monitorare. Thread, caroselli e testi lunghi usano tutti lo stesso array di contenuti.

Leggi la documentazione di pubblicazione
Risposta
{
  "post_status": "publishing",
  "deliveries": [
    { "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
    { "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
  ],
  "health_warnings": []
}

Blocchi di contenuto

I blocchi ordinati diventano un thread, un carosello o un testo a seconda della rete.

Media per riferimento

Carica una volta nella libreria multimediale e allega tramite id a tutti i post che vuoi.

Idempotente

Invia una chiave di idempotenza e una richiesta ripetuta non pubblica mai due volte.

Monitora

Sapere esattamente dove è arrivato ogni post

Un post si divide in una consegna per ogni account. Interroga l'endpoint delle consegne o iscriviti a un webhook e ottieni lo stato sulla piattaforma, l'id esterno, il permalink e il testo dell'errore quando una rete rifiuta qualcosa.

Vedi gli eventi webhook
Account collegati su tutte le reti in un unico workspace

Endpoint delle consegne

GET /v1/posts/:id/deliveries elenca ogni account con il proprio stato.

Eventi webhook

delivery.published e delivery.failed si attivano nel momento in cui una consegna si conclude.

Nuovi tentativi integrati

Gli errori temporanei delle piattaforme vengono ritentati con backoff prima di essere segnalati come falliti.

Gestisci

Modifica, annulla ed elimina dal codice

L'intero ciclo di vita è nell'API. Aggiorna un post programmato prima che esca, annullalo o elimina un post pubblicato dalla rete su cui è arrivato. Etichette e workspace tengono separato il lavoro dei clienti quando gestisci più brand.

Inizia a sviluppare
PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": [{ "text": "Updated copy." }] }'

Modifica prima della pubblicazione

Cambia testo, media o account su tutto ciò che è ancora in coda.

Etichette

Etichetta i post per campagna o cliente e filtra ogni endpoint di elenco per etichetta.

Workspace

Le chiavi sono per workspace, quindi un cliente non può mai raggiungerne un altro.

API di pubblicazione: le risposte alle tue domande

Come mi autentico?

Crea una chiave API nella dashboard in Impostazioni, poi inviala nell'header X-API-Key. Ogni chiave appartiene a un workspace e ha solo gli scope che le concedi.

Su quali reti posso pubblicare?

Su ogni account collegato al workspace, in tutte le reti supportate da FoPost. Il formato della richiesta è lo stesso per tutte.

Posso allegare immagini e video?

Sì. Carica una volta tramite la Media API, poi fai riferimento all'id del media nel post. I limiti di dimensione e formato di ogni rete vengono applicati per te.

Cosa succede se una rete non è disponibile?

La consegna viene ritentata con backoff. Se non riesce ancora, viene contrassegnata come fallita con l'errore della piattaforma e si attiva un webhook delivery.failed.

Esiste un limite di richieste?

Sì, 100 richieste al minuto per chiave. Il limite e il numero rimanente vengono restituiti negli header di risposta.

Esiste un SDK?

Un SDK TypeScript tipizzato, un server MCP per i client IA e pacchetti gratuiti per PHP, Laravel e WordPress. La specifica OpenAPI è servita dall'API per qualsiasi altro linguaggio.

Sviluppa oggi con API di pubblicazione

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

Ottieni la tua chiave API