Pengenalan API

API menyediakan REST endpoint untuk membaca dan mengelola data Sejoli dari luar WordPress. API ini berguna ketika Anda ingin menghubungkan Sejoli dengan aplikasi lain tanpa mengakses database secara langsung.

Base URL

Semua endpoint menggunakan namespace berikut:

/wp-json/sejoli/v1

Jika domain WordPress Anda adalah https://member.example.com, maka base URL API menjadi:

https://member.example.com/wp-json/sejoli/v1

Format Data

Sebagian besar endpoint menerima dan mengembalikan data dalam format JSON.

Header yang direkomendasikan:

Content-Type: application/json
Accept: application/json

Autentikasi

Sebagian besar endpoint menggunakan API key dengan format:

sejoliapi_<prefix>_<secret>

API key dikirim melalui header:

Authorization: Bearer sejoliapi_<prefix>_<secret>

atau:

X-Sejoli-Key: sejoliapi_<prefix>_<secret>

Hak Akses / Scopes

Setiap API key memiliki daftar permission atau scope. Scope menentukan endpoint mana yang bisa diakses oleh API key tersebut.

Contoh scope:

orders:read
orders:write
products:read
users:read

Jika API key tidak memiliki scope yang sesuai, API akan mengembalikan error 403 Insufficient scope.

API Key dan User-session

Sebagian besar endpoint menggunakan API key. API key dipakai oleh integrasi server/admin dan aksesnya dibatasi oleh scopes.

Untuk kebutuhan user-facing, API juga menyediakan alur user-session:

1. 1
   Step 1: Buat session

   Integrasi internal memanggil POST /sessions menggunakan API key dengan scope sessions:write.

2. 2
   Step 2: Terbitkan token

   API menerbitkan user-session token untuk user tertentu.

3. 3
   Step 3: Akses endpoint /me

   Aplikasi user-facing memakai token tersebut untuk mengakses endpoint /me/*.

Endpoint API biasa tetap menggunakan API key dan tidak perlu memanggil /me terlebih dahulu. Lihat halaman Session API dan Endpoint /me untuk detailnya.