Администрирование
Работа с API

JS коннектор

5min

API Пассворка позволяет получать, создавать и обновлять пароли, папки и хранилища. Это простой способ интегрировать Пассворк в инфраструктуру. API работает от имени пользователя, для которого используется API-ключ.

Пример установки

Создать директорию для клонирования репозитория:

shell


С помощью git склонировать репозиторий коннектора:

shell


Установить зависимости проекта перечисленные в файле — package.json:

shell


API ключ

Выполнить следующие действия:

  • Авторизоваться в веб-интерфейсе Пассворка;
  • Перейти в «Настройки и пользователи» → «Настройки API»;
  • Ввести пароль пользователя и получить API ключ.
Document image


Для работы с API важно обеспечить безопасность API ключа. Его нужно хранить в секрете и не передавать третьим лицам.

Чтобы получить временный API-токен, используйте метод login(...). Этот токен действует в рамках сессии, то есть пока совершаются запросы к API. Когда токен истекает, нужно снова войти в систему, чтобы сгенерировать новый.

Время жизни токена можно настроить в Пассворке. Это позволяет регулировать, как долго токен будет действовать.

После получения токен сохраняется и автоматически передаётся в заголовках HTTP-запросов, что упрощает работу с API.

Проверить наличие всех доступных методов API в Пассворк.

Примеры

Открыть сессию:

js


Сессия действует 10 минут (может быть изменена). Таким образом, можно выполнять несколько действий в рамках одной сессии, не выполняя вход в систему.

Получить пароль с помощью ID:

js

Обновлено 04 Oct 2024
Doc contributor
Помогла ли вам эта страница?