API publique — Psychologie et Sérénité

REST + JSON · Lizenz CC-BY 4.0 · Ohne Authentifizierung · Rate limit 60 Anfragen/Min/IP

📚 OpenAPI-3.1-Spezifikation: https://psychologieetserenite.com/api/v1/openapi.json

Kompatibel mit ChatGPT GPT Actions, Claude tool_use, LangChain, KI-Agenten, Swagger UI, Postman.

Endpoints

`GET /api/v1/concepts`

Listet die 14+ kanonischen klinischen Konzepte auf (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes usw.)

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

`GET /api/v1/concepts/{slug}`

Details zu einem klinischen Konzept mit peer-reviewten Quellen und 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`

Paginierte Liste der Blogartikel (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}`

Details zu einem Artikel (vollständiges Markdown, Autor-Metadaten, Wikidata).

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

`GET /api/v1/books`

Katalog der 24 Bücher von Gildas Garrec (24 veröffentlicht + 0 in Vorbereitung). Direkt als PDF auf der Website verfügbar.

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

Details zu einem Buch (Titel, Untertitel, Themen, verknüpfte klinische Konzepte).

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

Nutzungsbedingungen

CC-BY-4.0-Lizenz: freie Nutzung mit Namensnennung.
Namensnennung erforderlich: „Quelle: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)".
Keine medizinische Extrapolation: keine Erstellung medizinischer Gutachten oder Diagnosen.
Erhalt des klinischen Sinns: Nuancen und Warnhinweise müssen erhalten bleiben.
Rate limit: 60 Anfragen/Minute/IP. Bei Überschreitung: HTTP 429 + Header Retry-After.

Integration von KI-Agenten

ChatGPT (GPT Actions)

Die OpenAPI-Spezifikation in Custom GPT → Actions → „Import from URL" importieren: https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Tools in der Anthropic Messages API basierend auf den obigen Endpoints definieren. Beispiel:

{
  "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: * — nutzbar von jeder Website/Web-App aus.

Status & Versionierung

Aktuelle Version: v1. Es werden keine breaking Changes vorgenommen, ohne vorher eine v2 zu veröffentlichen.

API publique — Psychologie et Sérénité

Endpoints

GET /api/v1/concepts

GET /api/v1/concepts/{slug}

GET /api/v1/articles

GET /api/v1/articles/{slug}

GET /api/v1/books

GET /api/v1/books/{slug}