Autenticació

L'API suporta tres mètodes d'autenticació segons el vostre cas d'ús.

API Key

Per a integracions del costat del servidor. Genereu una clau des de la vostra pàgina d'API Keys i passeu-la mitjançant la capçalera X-Api-Key:

X-Api-Key: bws_a1b2c3d4e5f6...

Les API key tenen accés complet a tots els API endpoints — pujar, eliminar, llistar fitxers, gestionar configuració. No les exposeu mai en codi del costat del client.

TIP

Les API key no caduquen. Podeu crear múltiples claus i revocar-les individualment.

JWT Bearer Token

Per al tauler de control web i sessions autenticades per Cognito. Passeu el token mitjançant la capçalera Authorization:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Els JWT token els emet AWS Cognito quan un usuari inicia sessió al tauler de control d'IPFS Ninja. Caduquen automàticament i no estan pensats per a integracions directes d'API — utilitzeu API keys en el seu lloc.

Signed Upload Token

Per a pujades del costat del client sense exposar la vostra API key. Passeu el token mitjançant la capçalera Authorization:

Authorization: Signed sup_a1b2c3d4e5f6...

Els signed token tenen temps limitat i estan delimitats només a operacions de pujada. Són segurs per incrustar en aplicacions de navegador o mòbil. Genereu-los des del vostre servidor utilitzant POST /upload/signed-url i passeu-los al client.

Consulteu Signed Tokens per a detalls sobre la creació, llistat i revocació de signed upload tokens.