API Personativ v1

L'API di Personativ

Automatizzate il vostro workflow di contenuti: un input, per canale un post nativo scritto in modo autonomo nella voce del vostro brand. Conforme al GDPR, sovrano in UE, via REST.

URL base: https://personativ.de/api/v1

Autenticazione

Ogni richiesta si autentica tramite la chiave API del workspace nell'header X-API-Key. La chiave si genera nelle impostazioni sotto «Distribuzione / API». Trattatela come una password.

curl https://personativ.de/api/v1/me \
  -H "X-API-Key: dein_workspace_api_key"

Endpoint

GET

/api/v1/me

Info sul workspace e saldo credit attuale.

GET

/api/v1/channels

Canali social collegati.

GET

/api/v1/trends

Risultati attuali del radar delle tendenze con punteggio di rilevanza.

GET

/api/v1/articles

Elenco degli articoli pubblicati.

GET

/api/v1/articles/{slug}

Recupero del singolo articolo (incl. HTML).

POST

/api/v1/articles

Creazione di una bozza di articolo.

POST

/api/v1/compose

Fiore all'occhiello: un input, per canale un post nativo.

Esempio: crea una volta, distribuisci nativo per canale

Un articolo specialistico come input, da cui per canale un post autonomo. Consuma credit (acquisizione più un testo IA per canale).

curl -X POST https://personativ.de/api/v1/compose \
  -H "X-API-Key: dein_workspace_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "title": "5 Fehler bei der E-Rechnung",
    "input": "Kurzer Fachtext oder Stichpunkte ...",
    "platforms": ["linkedin", "twitter", "mastodon"]
  }'

Risposta (abbreviata):

{
  "articleId": "…",
  "title": "5 Fehler bei der E-Rechnung",
  "results": [
    { "platform": "linkedin", "content": "…", "hashtags": ["ERechnung"] },
    { "platform": "twitter",  "content": "…", "hashtags": ["…"] }
  ],
  "creditsCharged": 4,
  "credits": { "available": 196 }
}

JavaScript / Node

const res = await fetch("https://personativ.de/api/v1/compose", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CONTENTFLOW_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    input: "Euer Fachtext ...",
    platforms: ["linkedin", "twitter"]
  })
});
const data = await res.json();

Buono a sapersi

Rate limit: 60 richieste al minuto per chiave API.
Fatturazione con lo stesso modello a credit dell'app.
Elaborazione IA attivabile come sovrana in UE (modalità Sovereign), altrimenti serve una conferma UE una tantum.
Gli errori arrivano come JSON con error e code.

Ancora nessun workspace?

14 giorni gratis, API inclusa.

Inizia gratis

Domande frequenti

Come mi autentico all'API?+

Tramite la chiave API del workspace nell'header X-API-Key. La chiave si genera nelle impostazioni sotto «Distribuzione / API». Trattatela come una password.

Cosa fa l'endpoint /compose?+

Un input, per canale un post nativo scritto in modo autonomo nella voce del vostro brand. Consuma credit (acquisizione più un testo IA per canale).

C'e un rate limit?+

Si, 60 richieste al minuto per chiave API. La fatturazione avviene con lo stesso modello a credit dell'app.

L'API e conforme al GDPR?+

Si. L'elaborazione IA è attivabile come sovrana in UE (modalità Sovereign), altrimenti serve una conferma UE una tantum.

Esiste una descrizione OpenAPI?+

Si, su /api/v1/openapi.json. Gli errori arrivano come JSON con i campi error e code.