Удостоверяване

API-то поддържа три метода за удостоверяване в зависимост от вашия случай на употреба.

API ключ

За сървърни интеграции. Генерирайте ключ от страницата API ключове и го предайте чрез заглавието X-Api-Key:

X-Api-Key: bws_a1b2c3d4e5f6...

API ключовете имат пълен достъп до всички API крайни точки — качване, изтриване, списък на файлове, управление на настройки. Никога не ги излагайте в код от страна на клиента.

TIP

API ключовете нямат срок на валидност. Можете да създавате множество ключове и да ги отменяте поединично.

JWT Bearer Token

За уеб таблото за управление и сесии, удостоверени чрез Cognito. Предайте токена чрез заглавието Authorization:

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

JWT токените се издават от AWS Cognito, когато потребител влезе чрез таблото за управление на IPFS Ninja. Те изтичат автоматично и не са предназначени за директни API интеграции — вместо тях използвайте API ключове.

Подписан токен за качване

За качване от страна на клиента без разкриване на вашия API ключ. Предайте токена чрез заглавието Authorization:

Authorization: Signed sup_a1b2c3d4e5f6...

Подписаните токени са с ограничен срок и ограничени само до операции по качване. Безопасно е да се вграждат в браузърни или мобилни приложения. Генерирайте ги от вашия сървър чрез POST /upload/signed-url и ги предайте на клиента.

Вижте Подписани токени за подробности относно създаването, списъка и отмяната на подписани токени за качване.