API di Psychologie & Sérénité: accesso ai metadati e al catalogo

Gli sviluppatori di applicazioni di salute mentale, i ricercatori di psicologia e i creatori di assistenti IA condividono la stessa esigenza: accedere a dati psicologici affidabili e strutturati. È esattamente quello che propone l'API Psicologia e Serenità.

Perché un'API di psicologia gratuita?

La psicologia evidence-based (basata sulle prove) rimane troppo spesso rinchiusa in silos accademici. Gli articoli di divulgazione esistono, ma i loro metadati non sono facilmente sfruttabili da programmi informatici.

La nostra API colma questo vuoto esponendo metadati strutturati derivati da oltre 300 articoli scritti da uno psicoterapeuta TCC, che coprono i principali temi della psicologia clinica contemporanea.

Cosa offre l'API

1. Metadati degli articoli (300+)

L'endpoint `/api/articles` dà accesso ai metadati di tutti i nostri articoli pubblicati. Ogni articolo è categorizzato automaticamente tra 17 categorie tematiche: Attaccamento, Coppia, Ansia, TCC, Manipolazione, Dipendenza affettiva, Rottura e molti altri.

curl "https://psychologieetserenite.com/api/articles?theme=Couple&limit=5"

La risposta include il titolo, la descrizione, la categoria, la data di pubblicazione, il tempo di lettura stimato, il numero di parole e l'URL completo dell'articolo. Il contenuto completo dell'articolo non è mai esposto — solo i metadati vengono restituiti.

2. Catalogo di test psicologici (200)

L'endpoint `/api/tests` espone il catalogo completo di 206 test psicologici validi scientificamente, ospitati sulla nostra piattaforma dedicata (interfaccia disponibile in francese e inglese). Ogni test include un titolo, una descrizione, la durata stimata, il numero di domande e la categoria.

curl "https://psychologieetserenite.com/api/tests?category=anxiety"

Le categorie disponibili coprono: personalità, ansia, relazioni, ADHD, DOC, fobie, schemi dell'infanzia, depressione e sviluppo personale. Le domande e le scale di scoring non sono esposte.

3. Statistiche di ricerca

L'endpoint `/api/stats` fornisce dati aggregati provenienti da ricerche pubblicate: distribuzione degli stili di attaccamento, prevalenza dei disturbi d'ansia in Francia, efficacia delle TCC secondo le meta-analisi, schemi precoci più frequenti.

curl "https://psychologieetserenite.com/api/stats"

Ogni set di dati fa riferimento allo studio fonte e alla dimensione del campione.

Casi d'uso concreti

Specifiche tecniche

L'API è un'API REST classica che restituisce JSON. Non richiede alcuna chiave di autenticazione.

Il rate limiting è indicato nell'header `X-RateLimit-Remaining` di ogni risposta. In caso di superamento, viene restituito un codice 429 con un header `Retry-After`.

Dati protetti

L'API non fornisce mai:

• Il contenuto completo degli articoli (solo i metadati)
• Le domande e le scale di scoring dei test
• Dati individuali o personali
• Diagnosi o raccomandazioni mediche

Vuoi capire che cosa riceverebbe il lettore dopo aver seguito un link del catalogo? Consulta una scheda prodotto e il relativo esempio di report.

Come iniziare

// Esempio JavaScript
const response = await fetch('https://psychologieetserenite.com/api/articles?theme=Couple&limit=10');
const data = await response.json();
console.log(data.articles);

L'API è libera da usare con attribuzione. Semplicemente menziona « Fonte: Psicologia e Serenità - psychologieetserenite.com » nel tuo progetto.

Per qualsiasi domanda o suggerimento di miglioramento, contattaci a contact@psychologieetserenite.com.

FAQ

Quali limiti di frequenza (rate limit) si applicano?

L'API è limitata a 100 richieste all'ora per indirizzo IP. Ogni risposta include l'header `X-RateLimit-Remaining`; in caso di superamento del limite, l'API restituisce un codice 429 con un header `Retry-After` indicante i secondi da attendere.