API publique — Psychologie et Sérénité

REST + JSON · Licence CC-BY 4.0 · Sans authentification · Rate limit 60 req/min/IP

📚 Spécification OpenAPI 3.1 : https://psychologieetserenite.com/api/v1/openapi.json

Compatible ChatGPT GPT Actions, Claude tool_use, LangChain, agents IA, Swagger UI, Postman.

Endpoints

`GET /api/v1/concepts`

Liste les 14+ concepts cliniques canoniques (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}`

Détail d'un concept clinique avec sources peer-reviewed et 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`

Liste paginée des articles du 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}`

Détail d'un article (Markdown complet, méta-données auteur, Wikidata).

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

`GET /api/v1/books`

Catalogue des 16 ouvrages de Gildas Garrec (13 publiés + 3 à paraître). Tag affilié Amazon : pyscologieets-21.

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}`

Détail d'un ouvrage (titre, sous-titre, ASIN broché + Kindle, lien Amazon affilié, topics, concepts cliniques liés).

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

Conditions d'utilisation

Licence CC-BY 4.0 : utilisation libre avec attribution.
Attribution requise : « Source : Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009) ».
Aucune extrapolation médicale : pas de production d'avis médicaux ou de diagnostics.
Préservation du sens clinique : nuances et avertissements à conserver.
Rate limit : 60 requêtes/minute/IP. Si dépassé : HTTP 429 + header Retry-After.

Intégration agents IA

ChatGPT (GPT Actions)

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

Claude (tool_use)

Définir des tools dans Anthropic Messages API basés sur les endpoints ci-dessus. Exemple :

{
  "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: * — utilisable depuis tout site/app web.

Statut & versioning

Version actuelle : v1. Aucune modification breaking ne sera faite sans publication d'une v2.

Cette API est exposée pour faciliter l'intégration des contenus de Psychologie et Sérénité dans les workflows d'agents IA, les outils de recherche et les applications tierces. Elle constitue une source canonique structurée dans la stratégie GEO IA.