API publique — Psychologie et Sérénité

REST + JSON · Licenza CC-BY 4.0 · Nessuna autenticazione · Rate limit 60 richieste/min/IP

Endpoints

GET /api/v1/concepts

Elenca i 14+ concetti clinici canonici (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes, ecc.)

curl https://psychologieetserenite.com/api/v1/concepts
curl https://psychologieetserenite.com/api/v1/concepts?category=couple

GET /api/v1/concepts/{slug}

Dettaglio di un concetto clinico con fonti peer-reviewed e Wikidata.

curl https://psychologieetserenite.com/api/v1/concepts/attachement-bowlby
curl https://psychologieetserenite.com/api/v1/concepts/schema-young
curl https://psychologieetserenite.com/api/v1/concepts/gottman-couple

GET /api/v1/articles

Elenco paginato degli articoli del blog (fr/en).

curl "https://psychologieetserenite.com/api/v1/articles?lang=fr&limit=20&offset=0"
curl "https://psychologieetserenite.com/api/v1/articles?lang=en&limit=10&category=relations"

GET /api/v1/articles/{slug}

Dettaglio di un articolo (Markdown completo, metadati autore, Wikidata).

curl "https://psychologieetserenite.com/api/v1/articles/pere-absent-consequences-psychologiques?lang=fr"

GET /api/v1/books

Catalogo dei 24 volumi di Gildas Garrec (24 pubblicati + 0 di prossima uscita). Disponibili in PDF diretto sul sito.

curl https://psychologieetserenite.com/api/v1/books
curl https://psychologieetserenite.com/api/v1/books?status=published
curl https://psychologieetserenite.com/api/v1/books?topic=attachement

GET /api/v1/books/{slug}

Dettaglio di un volume (titolo, sottotitolo, argomenti, concetti clinici collegati).

curl https://psychologieetserenite.com/api/v1/books/comprendre-son-attachement
curl https://psychologieetserenite.com/api/v1/books/sauver-son-couple
curl https://psychologieetserenite.com/api/v1/books/loana-brulee-par-la-lumiere

Condizioni di utilizzo

• Licenza CC-BY 4.0: utilizzo libero con attribuzione.
• Attribuzione richiesta: «Fonte: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)».
• Nessuna estrapolazione medica: nessuna produzione di pareri medici o diagnosi.
• Preservazione del senso clinico: sfumature e avvertenze da conservare.
• Rate limit: 60 richieste/minuto/IP. Se superato: HTTP 429 + header Retry-After.

Integrazione con agenti IA

ChatGPT (GPT Actions)

Importare la spec OpenAPI in Custom GPT → Actions → «Import from URL»: https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Definire tools nella Anthropic Messages API basati sugli endpoint sopra indicati. Esempio:

{
  "name": "get_clinical_concept",
  "description": "Récupère le détail d'un concept clinique de psychologie",
  "input_schema": {
    "type": "object",
    "properties": {"slug": {"type": "string"}},
    "required": ["slug"]
  }
}

CORS

Access-Control-Allow-Origin: * — utilizzabile da qualsiasi sito/app web.

Stato e versioning

Versione attuale: v1. Nessuna modifica breaking sarà effettuata senza la pubblicazione di una v2.

Risorse correlate

• API Docs interattiva (Swagger UI) — testate i 6 endpoint direttamente dal browser, con esempi curl/JS/Python.
• Open Data — dataset esportati (Hugging Face, Kaggle), DOI permanente, citazioni BibTeX/APA pronte da copiare.
• Fonte IA — pagina di identità ufficiale (Wikidata, metodologia, condizioni di citazione).
• Documentazione per sviluppatori — guida all'integrazione.
• Glossario — 100 termini strutturati (DefinedTermSet schema.org).

Questa API viene esposta per facilitare l'integrazione dei contenuti di Psychologie et Sérénité nei workflow degli agenti IA, negli strumenti di ricerca e nelle applicazioni di terze parti. Costituisce una fonte canonica strutturata nella strategia GEO IA.