API publique — Psychologie et Sérénité

REST + JSON · 라이선스 CC-BY 4.0 · 인증 불필요 · 속도 제한 분당 60건/IP

📚 OpenAPI 3.1 명세: https://psychologieetserenite.com/api/v1/openapi.json

ChatGPT GPT Actions, Claude tool_use, LangChain, AI 에이전트, Swagger UI, Postman과 호환됩니다.

엔드포인트

`GET /api/v1/concepts`

14개 이상의 표준 임상 개념(볼비, 영, 벡, 가트맨, 스턴버그, 채프먼, 헤이즈 등) 목록을 제공합니다

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

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

동료 검토 출처와 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`

블로그 아티클의 페이지네이션된 목록(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}`

아티클 상세 정보(전체 Markdown, 저자 메타데이터, Wikidata).

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

`GET /api/v1/books`

질다스 가레크의 저서 24권 카탈로그(출간 24권 + 출간 예정 0권). 사이트에서 PDF로 바로 이용 가능합니다.

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

도서 상세 정보(제목, 부제, 주제, 관련 임상 개념).

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

이용 조건

CC-BY 4.0 라이선스: 출처 표시 시 자유롭게 이용 가능합니다.
출처 표시 필수: "출처: Psychologie et Sérénité — 질다스 가레크 (Wikidata Q138729009)".
의학적 추론 금지: 의학적 의견이나 진단을 생성하지 않습니다.
임상적 의미 보존: 뉘앙스와 주의사항을 유지해야 합니다.
Rate limit: 분당 60건/IP. 초과 시: HTTP 429 + 헤더 Retry-After.

AI 에이전트 연동

ChatGPT (GPT Actions)

Custom GPT → Actions → "Import from URL"에서 OpenAPI 명세를 가져오기: https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

위 엔드포인트를 기반으로 Anthropic Messages API에서 tools를 정의하세요. 예시:

{
  "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: * — 모든 웹사이트/웹 앱에서 사용 가능합니다.

상태 및 버전 관리

현재 버전: v1. 사전에 v2을(를) 공개하지 않고는 호환성이 깨지는 변경을 하지 않습니다.

API publique — Psychologie et Sérénité

엔드포인트

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}