API & Mappatura Dati

Architettura Headless & JSON

Akendor restituisce sempre un JSON strutturato e pronto all'uso. Come usare questi dati dipende esclusivamente dal tuo stack tecnologico. Il sistema prevede due scenari operativi: integrazione custom tramite sviluppo headless, oppure integrazione nativa e automatizzata direttamente nei CMS partner.

Scenario A: progetti custom (Sviluppo Headless)

Se stai sviluppando un portale frontend (usando framework come Next.js, React, Angular o Vue.js), un'applicazione mobile nativa o ibrida (ad esempio in React Native, SwiftUI, Kotlin o Flutter), oppure se utilizzi un'architettura backend custom o un'infrastruttura enterprise (come Google Cloud Platform, Azure, AWS di Amazon o basata su Node.js, Go, Laravel, Java Spring Boot e .NET Core), interrogherai le nostre API o riceverai i dati tramite Webhook.

Questo è un elenco non esaustivo: essendo Akendor un sistema completamente agnostico, distribuisce sempre l'oggetto JSON completo, ed è integrabile con qualsiasi linguaggio o stack in grado di parsare una risposta HTTP.

Il payload include l'albero editoriale, i testi, le FAQ e il blocco precompilato schema_markup, uniti alle metriche operative del tuo spazio di lavoro. Lo sviluppatore può semplicemente mappare i campi necessari al progetto e ignorare il resto.

akendor_workspace_payload.json

Raw Data

{
  "ideaId": "idea_99182",
  "lingua": "it",
  "categoria": "Salute Mentale",
  "dataArticolo": "2026-06-19T10:14:00.000Z",
  "metriche_operative": {
    "search_volume": 22200,
    "keyword_difficulty": 26,
    "punteggioSEO": 94,
    "embedding_vector": "[0.12, 0.88, 0.45, ...]"
  },
  "slug": "gestione-ansia-generalizzata",
  "titoloSeo": "Come gestire l'Ansia generalizzata nel 2026",
  "metaDescription": "Guida completa sulla gestione del GAD...",
  "parolaChiave": "ansia generalizzata",
  "titolo": "Come gestire l'Ansia generalizzata",
  "sottotitolo": "Strategie pratiche e insight clinici",
  "immagine": "https://cdn.akendor.com/img/ansia-cover.jpg",
  "sintesi": "L'ansia generalizzata richiede un approccio multifattoriale...",
  "conteggio_parole": 1450,
  "indice": ["Cos'è l'ansia", "Sintomi fisici", "Il ruolo del cortisolo"],
  "puntiChiave": ["L'ansia è un meccanismo naturale", "La respirazione abbassa il cortisolo"],
  "paragrafi": [
    {
      "id": "par_44x91",
      "titoloParagrafo": "Cos'è l'ansia",
      "contenuto": "<p>Il disturbo d'ansia generalizzata...</p>",
      "immagine": null,
      "insightPratico": {
        "tipo": "warning",
        "titoloBox": "Attenzione ai segnali fisici",
        "punti": ["Tachicardia improvvisa", "Tensione muscolare"]
      }
    }
  ],
  "faq": [
    { "domanda": "Quanto dura un attacco d'ansia?", "risposta": "Generalmente dai 10 ai 30 minuti..." }
  ],
  "riferimentiEsterni": ["https://pubmed.ncbi.nlm.nih.gov/..."],
  "schema_markup": {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "Come gestire l'Ansia generalizzata nel 2026",
    "description": "Guida completa sulla gestione del GAD...",
    "abstract": "L'ansia generalizzata richiede un approccio multifattoriale...",
    "image": "https://cdn.akendor.com/img/ansia-cover.jpg",
    "about": {
      "@type": "Thing",
      "name": "ansia generalizzata"
    },
    "mentions": ["Cortisolo", "Mindfulness", "Terapia Cognitivo Comportamentale"],
    "akendor_intelligence": {
      "entity_salience_score": 0.94,
      "topic_authority_fingerprint": "af_idea_99182"
    }
  }
}

Integrazione lato codice

Il developer utilizzerà i campi di testo e l'array dei paragrafi per popolare i componenti visivi, iniettando l'oggettoschema_markup direttamente nell'head della pagina per gestire in un colpo solo il posizionamento semantico (GEO) e i dati strutturati.

Scenario B: Integrazione Nativa

Se hai configurato Akendor per auto-pubblicare e iniettare gli articoli direttamente all'interno delle tue piattaforme collegate (come il modulo per WordPress o canali Firebase dedicati), la struttura si ottimizza per la produzione pubblica.

Akendor filtra il JSON a monte: rimuove i parametri di gestione interna come volumi di ricerca, ID delle idee e vettori di embedding che non servono al database pubblico del sito, inviando esclusivamente le chiavi necessarie alla corretta visualizzazione e all'indicizzazione immediata da parte delle intelligenze artificiali.

cms_injection_payload.json

Production

{
  "slug": "gestione-ansia-generalizzata",
  "lingua": "it",
  "titoloSeo": "Come gestire l'Ansia generalizzata nel 2026",
  "metaDescription": "Guida completa sulla gestione del GAD...",
  "titolo": "Come gestire l'Ansia generalizzata",
  "sottotitolo": "Strategie pratiche e insight clinici",
  "immagine": "https://cdn.akendor.com/img/ansia-cover.jpg",
  "sintesi": "L'ansia generalizzata richiede un approccio multifattoriale...",
  "conteggio_parole": 1450,
  "indice": ["Cos'è l'ansia", "Sintomi fisici", "Il ruolo del cortisolo"],
  "puntiChiave": ["L'ansia è un meccanismo naturale", "La respirazione abbassa il cortisolo"],
  "paragrafi": [
    {
      "id": "par_44x91",
      "titoloParagrafo": "Cos'è l'ansia",
      "contenuto": "<p>Il disturbo d'ansia generalizzata...</p>",
      "immagine": null,
      "insightPratico": {
        "tipo": "warning",
        "titoloBox": "Attenzione ai segnali fisici",
        "punti": ["Tachicardia improvvisa", "Tensione muscolare"]
      }
    }
  ],
  "faq": [
    { "domanda": "Quanto dura un attacco d'ansia?", "risposta": "Generalmente dai 10 ai 30 minuti..." }
  ],
  "riferimentiEsterni": ["https://pubmed.ncbi.nlm.nih.gov/..."],
  "schema_markup": {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "Come gestire l'Ansia generalizzata nel 2026",
    "description": "Guida completa sulla gestione del GAD...",
    "abstract": "L'ansia generalizzata richiede un approccio multifattoriale...",
    "image": "https://cdn.akendor.com/img/ansia-cover.jpg",
    "about": {
      "@type": "Thing",
      "name": "ansia generalizzata"
    },
    "mentions": ["Cortisolo", "Mindfulness", "Terapia Cognitivo Comportamentale"],
    "akendor_intelligence": {
      "entity_salience_score": 0.94,
      "topic_authority_fingerprint": "af_idea_99182"
    }
  }
}

Payload Leggero

Nessun dato di tracciamento strategico viene esposto sul web o salvato inutilmente nel CMS. Il database riceve un record pulito, ottimizzato per i motori di ricerca generativi e privo di elementi spazzatura.