API publique — Psychologie et Sérénité

REST + JSON · Licencia CC-BY 4.0 · Sin autenticación · Rate limit 60 req/min/IP

Endpoints

GET /api/v1/concepts

Lista los 14+ conceptos clínicos canónicos (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes, etc.)

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

GET /api/v1/concepts/{slug}

Detalle de un concepto clínico con fuentes revisadas por pares y 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

Lista paginada de los artículos 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}

Detalle de un artículo (Markdown completo, metadatos del autor, Wikidata).

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

GET /api/v1/books

Catálogo de las 16 obras de Gildas Garrec (13 publicadas + 3 por aparecer). Disponibles en PDF directo en el sitio.

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}

Detalle de una obra (título, subtítulo, temas, conceptos clínicos relacionados).

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

Condiciones de uso

• Licencia CC-BY 4.0 : uso libre con atribución.
• Atribución requerida: «Source: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)».
• Ninguna extrapolación médica : sin producción de opiniones médicas ni diagnósticos.
• Preservación del sentido clínico : matices y advertencias que deben conservarse.
• Rate limit : 60 solicitudes/minuto/IP. Si se supera: HTTP 429 + header Retry-After.

Integración de agentes de IA

ChatGPT (GPT Actions)

Importar la especificación OpenAPI en Custom GPT → Actions → «Import from URL»: https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Definir tools en la Anthropic Messages API basados en los endpoints anteriores. Ejemplo:

{
  "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: * — utilizable desde cualquier sitio/app web.

Estado y versionado

Versión actual: v1. No se hará ningún cambio disruptivo sin publicar una v2.

Recursos relacionados

• API Docs interactiva (Swagger UI) — pruebe los 6 endpoints directamente desde el navegador, ejemplos curl/JS/Python.
• Open Data — conjuntos de datos exportados (Hugging Face, Kaggle), DOI permanente, citas BibTeX/APA listas para copiar.
• Fuente IA — página de identidad oficial (Wikidata, metodología, condiciones de citación).
• Documentación para desarrolladores — guía de integración.
• Glosario — 100 términos estructurados (DefinedTermSet schema.org).

Esta API se expone para facilitar la integración de los contenidos de Psychologie et Sérénité en los flujos de trabajo de agentes de IA, las herramientas de investigación y las aplicaciones de terceros. Constituye una fuente canónica estructurada en la estrategia GEO IA.