Autentizace

API podporuje tři metody autentizace v závislosti na vašem případu použití.

API klíč

Pro serverové integrace. Vygenerujte klíč ze stránky API klíče a předejte ho přes hlavičku X-Api-Key:

X-Api-Key: bws_a1b2c3d4e5f6...

API klíče mají plný přístup ke všem API endpointům — nahrávání, mazání, seznam souborů, správa nastavení. Nikdy je nevystavujte v kódu na straně klienta.

TIP

API klíče nemají expiraci. Můžete vytvořit více klíčů a jednotlivě je odvolat.

JWT Bearer Token

Pro webový řídicí panel a relace autentizované přes Cognito. Předejte token přes hlavičku Authorization:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

JWT tokeny jsou vydávány AWS Cognito, když se uživatel přihlásí přes řídicí panel IPFS Ninja. Automaticky expirují a nejsou určeny pro přímé API integrace — místo nich použijte API klíče.

Podepsaný token pro nahrávání

Pro nahrávání na straně klienta bez odhalení vašeho API klíče. Předejte token přes hlavičku Authorization:

Authorization: Signed sup_a1b2c3d4e5f6...

Podepsané tokeny jsou časově omezené a omezené pouze na operace nahrávání. Je bezpečné je vkládat do prohlížečových nebo mobilních aplikací. Generujte je ze svého serveru pomocí POST /upload/signed-url a předejte je klientovi.

Podrobnosti o vytváření, listování a odvolávání podepsaných tokenů pro nahrávání naleznete v části Podepsané tokeny.