Arsitektur Dokumentasi

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

TULIS CMS/DEVELOPER HUB

/api-reference-auth-oauth

OAuth Login

Authentication

Tidak diperlukan untuk redirect. Callback di-handle otomatis oleh server.

OAuth Redirect

Mengarahkan pengguna ke halaman login penyedia OAuth.

Endpoint

GET /api/auth/:provider

Path Parameters

Parameter	Nilai	Description
`provider`	`google`, `github`, `gitlab`	Penyedia OAuth.

Flow

Arahkan browser ke https://YOUR_HOST/api/auth/google
Pengguna login di Google
Google mengembalikan callback ke https://YOUR_HOST/api/auth/google/callback
Server Tulis memverifikasi, membuat/menautkan akun, lalu redirect ke frontend dengan token

Konfigurasi .env

# Google OAuth
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URL=https://YOUR_HOST/api/auth/google/callback

# GitHub OAuth
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret
GITHUB_REDIRECT_URL=https://YOUR_HOST/api/auth/github/callback

# GitLab OAuth
GITLAB_CLIENT_ID=your-gitlab-client-id
GITLAB_CLIENT_SECRET=your-gitlab-client-secret
GITLAB_REDIRECT_URL=https://YOUR_HOST/api/auth/gitlab/callback

Redirect Callback

Setelah login berhasil, server Tulis akan redirect ke:

FRONTEND_URL/auth/callback?token=<jwt_token>&provider=google

Frontend wajib menangkap parameter token dan menyimpannya untuk request selanjutnya.

cURL Example (tidak bisa via curl — harus melalui browser)

Buka di browser:
https://YOUR_HOST/api/auth/google

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.