Lolos Auth API dengan Cara Fetch API dengan Bearer Token Javascript

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..., bukan Token: atau Auth:.
  • Tambahkan satu spasi setelah Bearer, tanpa kutip tambahan di dalam string.
  • Untuk request GET di browser, cukup tambahkan headers seperti contoh di atas, tanpa body.
  • 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

  1. Siapkan endpoint HTTPS dan token akses yang masih berlaku.
  2. Tulis fetch(url, { headers: { Authorization: `Bearer ${token}` } }), tambahkan method: "POST" bila API memintanya.
  3. Periksa response.ok dan baca response.status untuk membedakan sukses dan gagal auth.
  4. Ubah body ke JSON dengan await response.json() hanya setelah status dipastikan aman.
  5. Tangani kegagalan lewat try/catch untuk network error dan if untuk 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 Bearer plus 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.