Autentikasi

API mendukung tiga metode autentikasi tergantung pada kasus penggunaan Anda.

API Key

Untuk integrasi sisi server. Buat key dari halaman API Keys dan kirimkan melalui header X-Api-Key:

X-Api-Key: bws_a1b2c3d4e5f6...

API key memiliki akses penuh ke semua endpoint API — unggah, hapus, daftar file, kelola pengaturan. Jangan pernah mengeksposnya di kode sisi klien.

TIP

API key tidak kedaluwarsa. Anda dapat membuat beberapa key dan mencabutnya satu per satu.

JWT Bearer Token

Untuk dashboard web dan sesi yang diautentikasi Cognito. Kirimkan token melalui header Authorization:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Token JWT dikeluarkan oleh AWS Cognito saat pengguna masuk melalui dashboard IPFS Ninja. Token ini kedaluwarsa secara otomatis dan tidak dimaksudkan untuk integrasi API langsung — gunakan API key sebagai gantinya.

Token Unggah Bertanda Tangan

Untuk unggahan sisi klien tanpa mengekspos API key Anda. Kirimkan token melalui header Authorization:

Authorization: Signed sup_a1b2c3d4e5f6...

Token bertanda tangan memiliki batas waktu dan hanya berlaku untuk operasi unggah. Token ini aman untuk disematkan di aplikasi browser atau mobile. Buat dari server Anda menggunakan POST /upload/signed-url dan berikan ke klien.

Lihat Token Bertanda Tangan untuk detail tentang membuat, mendaftar, dan mencabut token unggah bertanda tangan.