API publique — Psychologie et Sérénité

REST + JSON · Lisenssi CC-BY 4.0 · Ei todennusta · Rate limit 60 pyyntöä/min/IP

Endpointit

GET /api/v1/concepts

Listaa yli 14 kanonista kliinistä käsitettä (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes jne.)

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

GET /api/v1/concepts/{slug}

Kliinisen käsitteen tiedot vertaisarvioiduin lähtein ja Wikidata-linkein.

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

Sivutettu lista blogiartikkeleista (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}

Artikkelin tiedot (koko Markdown-sisältö, kirjoittajan metatiedot, Wikidata).

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

GET /api/v1/books

Luettelo 24 kirjasta, jotka Gildas Garrec on kirjoittanut (24 julkaistu + 0 tulossa). Saatavilla suoraan PDF-muodossa sivustolla.

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}

Kirjan tiedot (nimi, alaotsikko, aiheet, liittyvät kliiniset käsitteet).

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

Käyttöehdot

• CC-BY 4.0 -lisenssi: vapaa käyttö lähdemerkinnällä.
• Lähdemerkintä vaaditaan: "Lähde: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)".
• Ei lääketieteellistä ekstrapolointia: ei lääketieteellisiä lausuntoja tai diagnooseja.
• Kliinisen merkityksen säilyttäminen: vivahteet ja varoitukset on säilytettävä.
• Rate limit: 60 pyyntöä/minuutti/IP. Ylityksessä: HTTP 429 + otsake Retry-After.

Tekoälyagenttien integrointi

ChatGPT (GPT Actions)

Tuo OpenAPI-määrittely Custom GPT:hen → Actions → "Import from URL": https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Määrittele työkalut Anthropic Messages API:ssa yllä olevien endpointtien perusteella. Esimerkki:

{
  "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: * — käytettävissä miltä tahansa verkkosivustolta/verkkosovelluksesta.

Tila ja versiointi

Nykyinen versio: v1. Yhtään rikkovaa muutosta ei tehdä ilman etukäteen julkaistua versiota v2.

Aiheeseen liittyvät resurssit

• Interaktiivinen API-dokumentaatio (Swagger UI) — testaa 6 endpointtia suoraan selaimessa, curl/JS/Python-esimerkein.
• Open Data — vietyjä tietoaineistoja (Hugging Face, Kaggle), pysyvä DOI, valmiit BibTeX/APA-viittaukset.
• Tekoälylähde — virallinen identiteettisivu (Wikidata, menetelmä, viittausehdot).
• Kehittäjädokumentaatio — integraatio-opas.
• Sanasto — 100 jäsenneltyä termiä (DefinedTermSet schema.org).

Tämä API on julkaistu helpottamaan Psychologie et Sérénité -sisällön integrointia tekoälyagenttien työnkulkuihin, tutkimustyökaluihin ja kolmansien osapuolten sovelluksiin. Se on jäsennelty kanoninen lähde tekoälyn GEO-strategiassa.