La API che scrive anche i contenuti

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 sul nostro endpoint (lo stesso dominio del resto dell'API) e inizi a chiamare: niente cookie, nessun utente di mezzo e nessun rinnovo OAuth rete per rete.

curl -X POST "https://api.planvortex.com/v1.0.0/oauth/token" \
  -d grant_type=client_credentials \
  -d client_id=$APP_CLIENT_ID \
  -d client_secret=$APP_SECRET

Il token scade. Attenzione: la scadenza NON arriva come 401, arriva come 400 con il codice 501 o 522 nel corpo. Richiedine un altro con la stessa chiamata.

Con la libreria Node questa chiamata non la scrivi: la fa lei, mette il token in cache e lo rinnova prima che scada.

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. Da Node, la libreria ufficiale porta i tipi e gestisce il token, i tentativi e il multipart.

import { PlanVortex } from "planvortex";

const pv = new PlanVortex({ clientId, clientSecret });

const upload = await pv.uploads.create(org, { file: "./hogaza.jpg" });
const post = await pv.publications.create(org, account, {
    social_network: "instagram",
    text: "Nuevo horno, nuevas hogazas",
    files: [upload._id],
    publish_date: new Date("2026-09-01T10:00:00Z"),
});