Token ditaruh di header Authorization dengan format Bearer <token>. Kesalahan yang paling sering membuat 401 bukan tokennya yang salah, melainkan penulisannya, misalnya kurang spasi setelah kata Bearer atau token terbungkus tanda kutip.
const res = await fetch("https://api.contoh.com/data", {
headers: {
"Authorization": `Bearer ${token}`
}
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
fetch tidak otomatis melempar error untuk status 401 atau 403. Kamu wajib memeriksa res.ok atau res.status sendiri sebelum memanggil res.json().
Format Header Authorization untuk Bearer Token
Server membaca token hanya dari satu string header. Formatnya baku dan peka huruf besar kecil pada kata Bearer.
- Gunakan
Authorization: Bearer eyJhbGciOi..., bukanToken:atauAuth:. - Tambahkan satu spasi setelah
Bearer, tanpa kutip tambahan di dalam string. - Untuk request GET di browser, cukup tambahkan
headersseperti contoh di atas, tanpabody. - Status 401 berarti token tidak dikenali atau kedaluwarsa, sedangkan 403 berarti token valid tetapi tidak punya izin akses endpoint tersebut.
Langkah Mengirim Bearer Token Pakai Fetch
- Siapkan endpoint HTTPS dan token akses yang masih berlaku.
- Tulis
fetch(url, { headers: { Authorization: `Bearer ${token}` } }), tambahkanmethod: "POST"bila API memintanya. - Periksa
response.okdan bacaresponse.statusuntuk membedakan sukses dan gagal auth. - Ubah body ke JSON dengan
await response.json()hanya setelah status dipastikan aman. - Tangani kegagalan lewat
try/catchuntuk network error danifuntuk HTTP error.
async function ambilData(token) {
try {
const res = await fetch("https://api.contoh.com/data", {
headers: { "Authorization": `Bearer ${token}` }
});
if (!res.ok) throw new Error(`Gagal: ${res.status}`);
return await res.json();
} catch (err) {
console.error(err.message);
}
}
- Endpoint memakai HTTPS agar token tidak terlihat di jaringan.
- Token masih aktif dan diambil dari login atau dashboard API.
- String header tersusun persis
Bearerplus satu spasi plus token.
Tabel Gagal Auth dan Cara Membetulkannya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| 401 Unauthorized | Token salah atau kedaluwarsa | Login ulang dan kirim token baru |
| 403 Forbidden | Token valid, hak akses kurang | Minta scope atau role yang sesuai |
| 401 karena format | Tertulis BearereyJ... |
Perbaiki jadi Bearer eyJ... |
| CORS diblokir | Server menolak origin browser | Izinkan origin di sisi server |
Network error terjadi saat koneksi putus sehingga fetch melempar TypeError. HTTP error terjadi saat server menjawab 401 atau 403 sehingga fetch tetap resolve. JSON parse error terjadi saat body bukan JSON, misalnya halaman HTML error dari server.
Jangan menyimpan secret permanen seperti API secret di frontend publik karena siapa pun dapat membacanya lewat DevTools.
FAQ
Di mana menaruh bearer token di fetch?
Taruh di opsi headers dengan kunci Authorization dan nilai Bearer plus token.
Kenapa fetch dengan bearer token tetap 401?
Token biasanya kedaluwarsa, salah salin, atau format stringnya kurang spasi setelah Bearer.
Apakah aman menyimpan bearer token di localStorage?
Tidak sepenuhnya aman karena skrip XSS dapat membacanya, jadi gunakan token berumur pendek dan hapus saat logout.