Документация Flussonic Watcher

Содержание

Импорт пользователей по API

В Flussonic Watcher есть API, которое позволяет разом заливать большое количество уже созданных пользователей и их настройки из внешней системы, базы данных или таблицы. Запросы к API должны быть авторизованы с помощью API-ключа. Для этого вы должны отправить API-ключ в http заголовке x-vsaas-api-key.

Вы можете найти свой APIKEY в разделе Настройки Watcher-а.

Для импорта списка пользователей надо сформировать CSV с полями и отправить на http(s)://URL_ВАШЕГО_ВОТЧЕРА/vsaas/api/v2/users/import:

  • login - Обязательное поле, используется для идентификации пользователей
  • email — E-mail используется для и восстановления пароля
  • password — пароль открытым текстом
  • is_active 1: активный пользователь, 0: пользователь заблокирован
  • is_admin 1: пользователь является администратором, 0 - обычный пользователь
  • note — комментарий к пользователю
  • Импорт через команду в консоли:

    curl --data-binary @mydata.csv -H 'Content-type:text/csv' -H 'x-vsaas-api-key: API_KEY_ВАШЕГО ВОТЧЕРА' http://WATCHER-HOSTNAME/vsaas/api/v2/users/import
    

    Пример файла mydata.csv:

    login,email,password,is_active,is_admin,note
    ivanov,ivanov@domain.tld,CergitMig,1,0,user1
    petrov,petrov@domain.tld,LajQuolOy,0,1,user2
    

    Пример одной строкой:

    echo -e "login,email,password,is_active,is_admin,note\nivanov,ivanov@domain.tld,CergitMig,1,0,user1\npetrov,petrov@domain.tld,LajQuolOy,0,1,user2" | curl http://127.0.0.1:80/vsaas/api/v2/users/import?type=csv --data-binary @-  -H 'Content-type:text/plain; charset=utf-8' -H 'x-vsaas-api-key: 3a7d9386-6c3a-440d-a75d-e6b3fdc3368e'
    

    Ответ:

    {"created":2,"updated":0,"deleted":0,"errors":{}}