API Client & Error Handling

API Client & Error Handling#

Seluruh komunikasi HTTP dari browser ke API Route Handlers dikelola melalui modul klien terpusat yang memiliki tipe data ketat (strongly typed).

1. Abstraksi requestJson<T>#

1import { requestJson } from "@/lib/apiClient";
2
3// Contoh pemanggilan dengan tipe balik yang aman
4const response = await requestJson<PatientRegistrationResponse>("/api/patients", {
5  method: "POST",
6  body: JSON.stringify(patientPayload),
7});

Fitur utama requestJson:

• Secara otomatis menyertakan header Content-Type: application/json dan credentials: "include".
• Melakukan unwrap JSON response dan melempar ApiError terstruktur jika status code bukan 2xx.
• Mendukung parameter timeoutMs untuk membatalkan request yang menggantung.

2. Struktur Error Response Terstandar#

1{
2  "error": "BAD_REQUEST",
3  "message": "NIK pasien wajib terdiri dari 16 digit angka yang valid.",
4  "code": 400,
5  "details": {
6    "field": "nik",
7    "received": "12345"
8  }
9}

3. Umpan Balik Notifikasi UI (Sonner)#

Kesalahan jaringan atau validasi ditampilkan kepada operator/dokter melalui notifikasi toast yang elegan menggunakan pustaka sonner:

• toast.success(message): Berhasil menyimpan data sesi atau verifikasi pasien.
• toast.error(message): Kegagalan koneksi sensor atau kesalahan validasi form.