API pubblica

Costruisci su PlanVortex

Collega le tue app a PlanVortex: pubblica contenuti, sincronizza le analitiche e ricevi eventi in tempo reale con la stessa API usata dal nostro pannello.

Vedi la documentazione Crea la tua prima app

Creare app proprie e usare l'API fa parte del piano Custom. Gli altri piani si usano dal pannello.

Autenticazione

Credenziali client, senza sessione utente

Ogni app che crei ha il proprio identificativo e il proprio segreto. Richiedi un token con il flusso client credentials e inizi a chiamare: niente cookie, nessun utente di mezzo e nessun rinnovo OAuth rete per rete. L'URL del tuo realm è nel pannello, accanto alle credenziali.

ottenere token

curl -X POST "$PLANVORTEX_AUTH_URL/protocol/openid-connect/token" \
  -d grant_type=client_credentials \
  -d client_id=$APP_CLIENT_ID \
  -d client_secret=$APP_SECRET

200 OK· access_token · expires_in

Il token scade. Quando l'API risponde 401, richiedine un altro con la stessa chiamata.

Prima chiamata

Pubblicare in poche righe

Scegli l'account e la rete di destinazione, invii il testo e i file caricati in precedenza, e PlanVortex si occupa del resto. Se aggiungi una data di pubblicazione, il post viene programmato invece di uscire subito.

node

const res = await fetch(`${API}/organizations/${org}/accounts/${acc}/publish`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: JSON.stringify({
    social_network: "instagram",
    text: "Nuevo horno, nuevas hogazas",
    files: ["66f1a2b3c4d5e6f7a8b9c0d1"],
    publish_date: "2026-09-01T10:00:00.000Z"
  })
});

Per chi è

Per chi è pensata

Pensata per chi sta già costruendo un proprio prodotto e vuole che i social ne facciano parte.

Agenzie

Centralizza la gestione dei clienti nel tuo pannello interno, senza che debbano accedere a PlanVortex.

Piattaforme e SaaS

Aggiungi pubblicazione e analitiche social al tuo prodotto senza costruirle da zero.

Team di prodotto

Collega PlanVortex al tuo stack interno: BI, CRM, automazioni.

Casi d'uso

Quello che puoi già automatizzare oggi con la API.

Pubblicare e programmare

Crea, programma e pubblica contenuti sugli account collegati, via codice.

Sincronizzare le analitiche

Porta le metriche di ogni account e pubblicazione nel tuo pannello.

Webhook in tempo reale

Ricevi eventi immediati quando cambiano account, messaggi o pubblicazioni — senza polling.

Connessione integrata

Lascia che i tuoi utenti colleghino i social senza uscire dal tuo prodotto.

Come iniziare

Da zero alla tua prima chiamata autenticata.

Crea un'app
Dal tuo pannello cliente, dai un nome alla tua app e attivala. Disponibile nel piano Custom.
Ottieni le credenziali
Un identificativo client e un segreto, che puoi ruotare quando vuoi dal pannello.
Autenticati
Usa il flusso client-credentials per ottenere il tuo token di accesso.
Esplora la API
Consulta la documentazione interattiva e verifica ogni endpoint disponibile.

Riferimento

Gli endpoint che userai il primo giorno

Partono tutti dalla stessa base e si autenticano con l'header Authorization: Bearer. Il riferimento completo, con ogni parametro e le risposte di esempio, è nella documentazione.

URL basehttps://api.planvortex.com/v1.0.0

Metodo	Endpoint	A cosa serve
POST	/clients/{id_client}/apps	Creare un'app all'interno del tuo account cliente.
GET	/clients/{id_client}/apps/{id_app}/secret	Consultare il segreto dell'app per poterti autenticare.
GET	/organizations/{id_organization}/accounts	Elencare gli account collegati di un'organizzazione e il loro stato.
GET	/organizations/{id_organization}/login_links	Generare i link con cui il tuo utente collega le sue reti senza uscire dal tuo prodotto.
POST	/organizations/{id_organization}/uploads	Caricare l'immagine o il video prima di pubblicarlo.
POST	/organizations/{id_organization}/accounts/{id_account}/publish	Pubblicare o programmare su un account specifico.
GET	/organizations/{id_organization}/publish	Consultare le pubblicazioni dell'organizzazione e in che stato si trovano.
GET	/organizations/{id_organization}/publish/{id_publication}/metrics	Metriche di una pubblicazione specifica.
GET	/organizations/{id_organization}/accounts/{id_account}/metrics	Metriche dell'account.
GET	/organizations/{id_organization}/limits	Consumo e limiti del piano in quel momento.

Webhook

Eventi che ti inviamo

Imposti un URL nella tua app e PlanVortex ci fa una POST quando succede qualcosa sugli account collegati. Ogni invio è firmato con il segreto dell'app, così puoi verificare che arrivi davvero da noi.

new_account

Un utente ha appena collegato un nuovo account.

change_state_account

Lo stato di un account è cambiato: è stato ricollegato, il token è scaduto o non è più disponibile.

messages

È arrivato un messaggio diretto su un account collegato.

mentions

Qualcuno ha menzionato uno dei tuoi account.

Versionamento

La versione fa parte del percorso. Finché resta lì, quello che oggi ti funziona continuerà a funzionare allo stesso modo.

Firma dei webhook

Ogni POST porta gli header x-hub-signature e x-hub-signature-256, calcolati con il segreto della tua app. Verificali prima di elaborare il corpo.

Documentazione interattiva

Riferimento OpenAPI per aree — account, pubblicazioni, caricamenti, organizzazioni, ruoli e piani di IA — con ogni parametro e la sua risposta di esempio.

Documentazione

Tutta la API, documentata

Endpoint, parametri e risposte di esempio — con la stessa palette e tipografia di PlanVortex, per non sentirsi mai fuori dal sito.

Vedi la documentazione Parla con noi