Dokumentasi Resmi
|tulis.org

Arsitektur Dokumentasi

Peta jalan panduan, SDK integration, dan API reference lengkap yang disiapkan secara terstruktur.

TULIS CMS/DEVELOPER HUB
/api-reference-auth-register

Register

Mendaftarkan akun pengguna baru di Tulis CMS. Setelah registrasi berhasil, sistem akan mengirim email verifikasi ke alamat email yang didaftarkan.

Endpoint

POST /api/register

Authentication

Tidak diperlukan. Endpoint ini publik.

Request Body

FieldTypeRequiredDescription
namestringyaNama lengkap pengguna.
emailstringyaAlamat email (harus unik).
passwordstringyaPassword (minimal 8 karakter).
{
  "name": "Ahmad Fulan",
  "email": "ahmad@example.com",
  "password": "rahasia123"
}

Response

{
  "status": 201,
  "message": "Registration successful. Please check your email to verify your account.",
  "data": {
    "id": "c3d4e5f6-3333-4444-5555-666677778888",
    "name": "Ahmad Fulan",
    "email": "ahmad@example.com",
    "role": "user"
  }
}

cURL Example

curl -X POST "https://YOUR_HOST/api/register" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ahmad Fulan",
    "email": "ahmad@example.com",
    "password": "rahasia123"
  }'

Catatan

  • Email verifikasi dikirim otomatis. Akun belum bisa digunakan sebelum email diverifikasi.
  • Jika ALLOW_REGISTRATION=false di .env, endpoint ini akan menolak semua permintaan registrasi.
  • Untuk registrasi melalui undangan (invitation), gunakan endpoint Register by Invitation.

Register by Invitation

Mendaftar menggunakan token undangan yang dikirim oleh admin workspace.

Endpoint

POST /api/register/invitation

Request Body

FieldTypeRequiredDescription
tokenstringyaToken undangan dari admin.
namestringyaNama lengkap.
passwordstringyaPassword (minimal 8 karakter).
{
  "token": "abc123def456...",
  "name": "Aisyah binti Abu Bakar",
  "password": "rahasia456"
}

Response

{
  "status": 201,
  "message": "Account created. You have been added to the workspace.",
  "data": {
    "id": "d4e5f6a7-4444-5555-6666-777788889999",
    "name": "Aisyah binti Abu Bakar",
    "email": "aisyah@example.com",
    "role": "author"
  }
}

Lini Masa Peluncuran Fitur

Fase 1: Setup Awal & KonfigurasiSELESAI

Docker Compose, pengaturan file environment, dan panduan setup lokal telah lengkap dibuat.

Fase 2: Referensi RESTful APISELESAI

Dokumentasi route endpoint publik, otentikasi JWT, dan kontrol hak akses telah selesai disusun.

Fase 3: Integrasi Frontend & Fitur LanjutSEDANG BERJALAN

Mempersiapkan boilerplate untuk Next.js client, manajemen revisi konten, dan optimasi query.