API publique — Psychologie et Sérénité

REST + JSON · License CC-BY 4.0 · No authentication · Rate limit 60 req/min/IP

Endpoints

GET /api/v1/concepts

Lists the 14+ canonical clinical concepts (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}

Details of a clinical concept with peer-reviewed sources and 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

Paginated list of blog articles (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}

Article details (full Markdown, author metadata, Wikidata).

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

GET /api/v1/books

Catalog of 16 books by Gildas Garrec (13 published + 3 forthcoming). Available as direct PDF on the site.

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}

Book details (title, subtitle, topics, related clinical concepts).

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

Terms of use

• CC-BY 4.0 license : free use with attribution.
• Attribution required: "Source: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)".
• No medical extrapolation : no generation of medical advice or diagnoses.
• Preservation of clinical meaning : nuances and warnings to be kept.
• Rate limit : 60 requests/minute/IP. If exceeded: HTTP 429 + header Retry-After.

AI agent integration

ChatGPT (GPT Actions)

Import the OpenAPI spec into Custom GPT → Actions → "Import from URL": https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Define tools in the Anthropic Messages API based on the endpoints above. Example:

{
  "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: * — usable from any website/web app.

Status & versioning

Current version: v1. No breaking change will be made without publishing a v2.

Related resources

• Interactive API Docs (Swagger UI) — test the 6 endpoints directly from the browser, curl/JS/Python examples.
• Open Data — exported datasets (Hugging Face, Kaggle), permanent DOI, ready-to-copy BibTeX/APA citations.
• AI Source — official identity page (Wikidata, methodology, citation conditions).
• Developer documentation — integration guide.
• Glossary — 100 structured terms (DefinedTermSet schema.org).

This API is exposed to facilitate the integration of Psychologie et Sérénité content into AI agent workflows, research tools and third-party applications. It is a structured canonical source in the AI GEO strategy.