API publique — Psychologie et Sérénité

REST + JSON · Licentie CC-BY 4.0 · Geen authenticatie · Rate limit 60 verzoeken/min/IP

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

Compatibel met ChatGPT GPT Actions, Claude tool_use, LangChain, AI-agenten, Swagger UI, Postman.

Endpoints

`GET /api/v1/concepts`

Toont de 14+ canonieke klinische concepten (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes, enz.)

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

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

Details van een klinisch concept met peer-reviewed bronnen en 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`

Gepagineerde lijst van blogartikelen (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 van een artikel (volledige Markdown, metadata van de auteur, Wikidata).

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

`GET /api/v1/books`

Catalogus van de 24 boeken van Gildas Garrec (24 gepubliceerd + 0 aankomend). Rechtstreeks beschikbaar als PDF op de 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}`

Details van een boek (titel, ondertitel, onderwerpen, gerelateerde klinische concepten).

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

Gebruiksvoorwaarden

CC-BY 4.0-licentie: vrij gebruik met bronvermelding.
Bronvermelding verplicht: "Bron: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)".
Geen medische extrapolatie: geen medisch advies of diagnoses.
Behoud van klinische betekenis: nuances en waarschuwingen moeten behouden blijven.
Rate limit: 60 verzoeken/minuut/IP. Bij overschrijding: HTTP 429 + header Retry-After.

Integratie van AI-agenten

ChatGPT (GPT Actions)

Importeer de OpenAPI-spec in Custom GPT → Actions → "Import from URL": https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Definieer tools in de Anthropic Messages API op basis van bovenstaande endpoints. Voorbeeld:

{
  "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: * — bruikbaar vanaf elke website/webapp.

Status en versiebeheer

Huidige versie: v1. Er wordt geen enkele breaking change doorgevoerd zonder voorafgaande publicatie van een v2.

Gerelateerde bronnen

Interactieve API-documentatie (Swagger UI) — test de 6 endpoints rechtstreeks vanuit de browser, met curl/JS/Python-voorbeelden.
Open Data — geëxporteerde datasets (Hugging Face, Kaggle), permanente DOI, kant-en-klare BibTeX/APA-citaten.
AI-bron — officiële identiteitspagina (Wikidata, methodologie, citatievoorwaarden).
Ontwikkelaarsdocumentatie — integratiehandleiding.
Verklarende woordenlijst — 100 gestructureerde termen (DefinedTermSet schema.org).

Deze API wordt beschikbaar gesteld om de integratie van de content van Psychologie et Sérénité in workflows van AI-agenten, onderzoekstools en toepassingen van derden te vergemakkelijken. Het vormt een gestructureerde canonieke bron in de AI GEO-strategie.