L'API di Personativ

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

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 errori con la fattura elettronica",
    "input": "Breve testo tecnico o punti chiave sull'obbligo di fattura elettronica ...",
    "platforms": ["linkedin", "twitter", "mastodon"]
  }'

Risposta (abbreviata):

{
  "articleId": "…",
  "title": "5 errori con la fattura elettronica",
  "results": [
    { "platform": "linkedin", "content": "…", "hashtags": ["fatturaelettronica"] },
    { "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: "Il vostro testo tecnico o i vostri punti chiave ...",
    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.