Pengenalan

Panduan ini akan membantu Anda memulai integrasi dengan Fumai Mobile API.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

Akun Fumai yang sudah terverifikasi
Pemahaman dasar tentang REST API dan JSON
JWT-based authentication (Bearer token)

Arsitektur Token

Fumai Mobile API menggunakan JWT-based authentication dengan Bearer token:

Token	Masa Berlaku	Fungsi
Access Token	15 menit	Autentikasi semua request
Refresh Token	30 hari	Mendapatkan access token baru

Environment

Environment	Base URL
Production	`https://fumai.app/api/mobile/v1`

Langkah Awal

Gunakan endpoint autentikasi untuk mendapatkan access token. Fumai menggunakan unified auth flow — satu alur untuk login dan register:

Panggil POST /auth/check-email untuk cek status email
Berdasarkan response, lanjutkan ke login, register, atau OAuth

Lihat detail di Autentikasi.

2. Lakukan Request Pertama

Setelah mendapatkan access token, coba panggil endpoint untuk mendapatkan data user:


curl -X GET https://fumai.app/api/mobile/v1/auth/me \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"


const res = await fetch('https://fumai.app/api/mobile/v1/auth/me', {
  headers: { Authorization: `Bearer ${accessToken}` },
})
const data = await res.json()

3. Selesaikan Onboarding

User baru wajib menyelesaikan onboarding sebelum menggunakan fitur utama. Lihat Onboarding untuk detail.

Alur Lengkap User


Register/Login → Verifikasi Email → Onboarding → Dashboard → FitMatch (opsional)

Info: Lihat bagian API Reference untuk detail setiap endpoint.