Authentication

Ang API ay sumusuporta ng tatlong paraan ng authentication depende sa iyong use case.

API Key

Para sa server-side integration. Bumuo ng key mula sa iyong API Keys page at ipasa ito sa pamamagitan ng X-Api-Key header:

X-Api-Key: bws_a1b2c3d4e5f6...

Ang mga API key ay may buong access sa lahat ng API endpoint — upload, delete, list files, manage settings. Huwag itong i-expose sa client-side code.

TIP

Hindi nag-e-expire ang mga API key. Maaari kang gumawa ng maraming key at i-revoke ang mga ito nang isa-isa.

JWT Bearer Token

Para sa web dashboard at mga Cognito-authenticated session. Ipasa ang token sa pamamagitan ng Authorization header:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Ang mga JWT token ay ini-issue ng AWS Cognito kapag nag-sign in ang user sa IPFS Ninja dashboard. Awtomatiko silang nag-e-expire at hindi ginawa para sa direktang API integration — gumamit ng mga API key sa halip.

Signed Upload Token

Para sa client-side uploads nang hindi ine-expose ang iyong API key. Ipasa ang token sa pamamagitan ng Authorization header:

Authorization: Signed sup_a1b2c3d4e5f6...

Ang mga signed token ay time-limited at naka-scope sa upload operation lang. Ligtas silang i-embed sa browser o mobile application. Buuin ang mga ito mula sa iyong server gamit ang POST /upload/signed-url at ibigay sa client.

Tingnan ang Signed Tokens para sa mga detalye tungkol sa paggawa, paglilista, at pag-revoke ng mga signed upload token.