API publique — Psychologie et Sérénité

REST + JSON · Lisensi CC-BY 4.0 · Tanpa autentikasi · Rate limit 60 permintaan/menit/IP

Endpoint

GET /api/v1/concepts

Mencantumkan 14+ konsep klinis kanonis (Bowlby, Young, Beck, Gottman, Sternberg, Chapman, Hayes, dll.)

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

GET /api/v1/concepts/{slug}

Detail suatu konsep klinis dengan sumber peer-review dan 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

Daftar artikel blog berhalaman (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}

Detail sebuah artikel (Markdown lengkap, metadata penulis, Wikidata).

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

GET /api/v1/books

Katalog 24 buku karya Gildas Garrec (24 terbit + 0 akan terbit). Tersedia dalam PDF langsung di situs.

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}

Detail sebuah buku (judul, subjudul, topik, konsep klinis terkait).

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

Ketentuan penggunaan

• Lisensi CC-BY 4.0: penggunaan bebas dengan atribusi.
• Atribusi wajib: "Sumber: Psychologie et Sérénité — Gildas Garrec (Wikidata Q138729009)".
• Tanpa ekstrapolasi medis: tidak menghasilkan opini medis atau diagnosis.
• Pelestarian makna klinis: nuansa dan peringatan harus dipertahankan.
• Rate limit: 60 permintaan/menit/IP. Jika terlampaui: HTTP 429 + header Retry-After.

Integrasi agen AI

ChatGPT (GPT Actions)

Impor spesifikasi OpenAPI di Custom GPT → Actions → "Import from URL": https://psychologieetserenite.com/api/v1/openapi.json

Claude (tool_use)

Definisikan tools di Anthropic Messages API berdasarkan endpoint di atas. Contoh:

{
  "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: * — dapat digunakan dari situs web/aplikasi web mana pun.

Status & pemversian

Versi saat ini: v1. Tidak akan ada perubahan besar yang dilakukan tanpa penerbitan v2 terlebih dahulu.

Sumber daya terkait

• Dokumentasi API interaktif (Swagger UI) — uji langsung 6 endpoint dari peramban, dengan contoh curl/JS/Python.
• Open Data — dataset yang diekspor (Hugging Face, Kaggle), DOI permanen, sitasi BibTeX/APA siap salin.
• Sumber AI — halaman identitas resmi (Wikidata, metodologi, ketentuan sitasi).
• Dokumentasi pengembang — panduan integrasi.
• Glosarium — 100 istilah terstruktur (DefinedTermSet schema.org).

API ini disediakan untuk memudahkan integrasi konten Psychologie et Sérénité ke dalam alur kerja agen AI, alat riset, dan aplikasi pihak ketiga. API ini merupakan sumber kanonis terstruktur dalam strategi GEO AI.