API di programmazioneAPI

Programma un post con un solo campo

Invia lo stesso corpo che useresti per pubblicare subito, aggiungi un timestamp schedule_at e FoPost lo tiene in coda fino a quel momento. Tutto resta modificabile fino all'istante dell'uscita, e la consegna viene riportata per ogni account.

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-...",
    "status": "scheduled",
    "schedule_at": "2026-09-01T09:00:00Z",
    "content": [{ "text": "Webhook retries are live. Read the changelog." }],
    "accounts": ["4a71d80b-...", "c30e9f12-..."]
  }'

Un solo timestamp

Qualsiasi orario ISO 8601 nel futuro. La coda lo prende in carico e pubblica come programmato.

Modificabile fino all'invio

Usa PUT per cambiare testo, media, account o orario di tutto ciò che è ancora in coda.

Consegna per account

Una volta uscito, ogni account riporta il proprio stato e il permalink.

Coda di pubblicazione

Pianifica una settimana di post con un solo script

Scorri i tuoi contenuti, scegli un orario per ognuno e crea i post. La coda gira in FoPost, quindi il tuo processo può terminare non appena la richiesta risponde. Elenca i post programmati in qualsiasi momento per vedere cosa sta per uscire.

Leggi la documentazione dei post
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
    { "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}

Filtra per stato

Elenca bozze, post programmati, pubblicati o falliti con un solo parametro di query.

Etichette

Etichetta ogni post per campagna e filtra la coda per etichetta.

Per workspace

Una chiave vede un solo workspace, quindi la coda di un cliente non si mescola mai con quella di un altro.

Modifica

Sposta, riscrivi o annulla prima dell'uscita

I piani cambiano. Usa PUT su un post programmato per cambiarne orario, testo, media o account di destinazione. Se lo annulli viene contrassegnato come annullato e non viene mai consegnato, oppure eliminalo del tutto. Nulla è bloccato finché la coda non lo prende in carico.

Vedi l'endpoint PUT
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 '{ "schedule_at": "2026-09-01T14:00:00Z" }'

Riprogramma

Cambia schedule_at e la coda sposta il post al nuovo orario.

Sostituisci il contenuto

Sostituisci l'array di contenuti o gli id dei media di un post in coda.

Annulla o elimina

Togli un post dalla coda senza toccare nient'altro.

Conferma

Sapere quando è arrivato, senza polling

All'orario programmato, il post si divide in una consegna per ogni account. Registra un webhook e delivery.published o delivery.failed si attiva per ognuna, oppure interroga l'endpoint delle consegne se preferisci un modello pull.

Inizia a sviluppare
Un mese di post programmati nel calendario di pubblicazione

Webhook alla conclusione

delivery.published contiene l'id del post, l'account e il permalink.

Nuovi tentativi

Gli errori di rete temporanei vengono ritentati con backoff prima che venga segnalato un fallimento.

Analisi successive

Una volta online, lo stesso id del post restituisce impression ed engagement dall'Analytics API.

API di programmazione: le risposte alle tue domande

Con quanto anticipo posso programmare?

Con tutto l'anticipo che vuoi. È accettato qualsiasi timestamp ISO 8601 futuro e la coda conserva il post fino a quel momento.

Quale fuso orario usa schedule_at?

Invia un timestamp ISO 8601 in UTC, che termina con Z. Il valore che invii è quello che viene eseguito; sul server non avviene alcuna conversione.

Posso modificare un post dopo averlo programmato?

Sì. Usa PUT su qualsiasi campo, orario compreso, di un post non ancora uscito. Una volta pubblicato, le modifiche si applicano al record, e per rimuoverlo da una rete usi l'eliminazione.

Cosa succede se il mio server non è disponibile al momento della pubblicazione?

Nulla cambia. La coda gira dentro FoPost, non sulla tua infrastruttura, quindi il post esce che il tuo processo sia in esecuzione o meno.

Posso programmare solo su alcuni account?

Sì. L'array accounts è l'elenco delle destinazioni. Includi solo gli account che devono ricevere il post, e ognuno avrà il proprio record di consegna.

Esiste un limite di richieste?

Sì, 100 richieste al minuto per chiave. Programmare una settimana di post con un solo script rientra comodamente nel limite.

Sviluppa oggi con API di programmazione

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

Ottieni la tua chiave API