API Docs — Documentation interactive

OpenAPI 3.1 · CC-BY 4.0 · Swagger UI · Test direct depuis le navigateur

📦 Spec OpenAPI brute : https://psychologieetserenite.com/api/v1/openapi.json

Importable dans : Postman, ChatGPT Custom GPT (Actions), Claude tool_use, Insomnia, swagger-codegen, openapi-generator.

JavaScript est désactivé. Pour la documentation interactive, activez JavaScript.

Spec brute disponible : https://psychologieetserenite.com/api/v1/openapi.json

Résumé des 6 endpoints publics

Méthode	Path	Description
GET	/concepts	Liste les 14 concepts cliniques canoniques
GET	/concepts/{slug}	Détail d'un concept (Bowlby, Young, Beck, etc.)
GET	/articles	Liste paginée des articles (filtres lang, theme, page, limit)
GET	/articles/{slug}	Détail d'un article par slug
GET	/books	Catalogue des 16 ouvrages avec ASIN, formats, thèmes
GET	/books/{slug}	Détail d'un ouvrage

Exemples d'utilisation

curl (CLI)

# Liste des 14 concepts
curl -s https://psychologieetserenite.com/api/v1/concepts

# Détail d'un concept
curl -s https://psychologieetserenite.com/api/v1/concepts/gottman-couple

# Articles paginés
curl -s "https://psychologieetserenite.com/api/v1/articles?lang=fr&limit=10&page=1"

# Article par slug
curl -s https://psychologieetserenite.com/api/v1/articles/anxiete-couple

# Catalogue 16 livres
curl -s https://psychologieetserenite.com/api/v1/books

# Spec OpenAPI brute
curl -s https://psychologieetserenite.com/api/v1/openapi.json

JavaScript (fetch)

// Récupérer la liste des concepts
const res = await fetch('https://psychologieetserenite.com/api/v1/concepts');
const data = await res.json();
console.log(`${data.length} concepts cliniques`);

// Avec filtres (articles)
const articles = await fetch(
  'https://psychologieetserenite.com/api/v1/articles?lang=fr&theme=anxiete&limit=20'
).then(r => r.json());

Python (requests)

import requests

# Tous les concepts cliniques
r = requests.get('https://psychologieetserenite.com/api/v1/concepts')
concepts = r.json()
for c in concepts:
    print(c['slug'], '—', c['title_fr'])

# Catalogue de livres
books = requests.get('https://psychologieetserenite.com/api/v1/books').json()
print(f"{len(books)} livres au catalogue")

ChatGPT Custom GPT (Actions)

Dans Custom GPT → onglet Actions → Import from URL
Coller : https://psychologieetserenite.com/api/v1/openapi.json
L'assistant peut désormais interroger les 6 endpoints en langage naturel

Anthropic Claude (tool_use)

{
  "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", "description": "Slug du concept" }
    },
    "required": ["slug"]
  }
}

CORS et limites

CORS : Access-Control-Allow-Origin: * sur tous les endpoints
Méthodes autorisées : GET, OPTIONS
Headers autorisés : Content-Type, Accept
Rate limit : 60 requêtes / minute / IP
Auth : aucune
Format réponse : application/json; charset=utf-8

Citation

Si vous utilisez cette API en recherche ou production, merci de citer :

@misc{gildas_garrec_2026,
    title={Psychology Articles Metadata — Bilingual FR/EN},
    url={https://www.kaggle.com/dsv/16001562},
    DOI={10.34740/KAGGLE/DSV/16001562},
    publisher={Kaggle},
    author={Gildas Garrec},
    year={2026}
}

Ressources liées

Documentation API (vue résumée)
Open Data hub — datasets HF/Kaggle, DOI permanent, citations BibTeX/APA
Source IA officielle — identifiants Wikidata, méthodologie clinique
Glossaire — 100 termes structurés (DefinedTermSet)
Organisation Hugging Face
Dataset Kaggle (avec DOI)

Documentation Swagger UI servie via unpkg.com/swagger-ui-dist (CDN, MIT). License de l'API : CC-BY 4.0.