Документация REST API

Документация REST API

Актуальная документация по методам REST API в формате Swagger доступна после установки платформы по адресу
http(s)://{domain_name}/v3/api/v1/swagger/index.html
где {domain_name} - IP-адрес или доменное имя вашей платформы.

Чтобы получить токен для взаимодействия с публичным API, необходимо отправить отправить POST запрос на сервер к которому необходимо получить токен доступа:
POST http(s)://<domain>/v3/keycloak/realms/Visiology/protocol/openid-connect/token

где <domain> – домен или IP-адрес сервера платформы.

Пример запроса в Postman:

POST http://192.168.42.87/v3/keycloak/realms/Visiology/protocol/openid-connect/token

 

Key

Value

 

Key

Value

Body

x-www-form-urlencoded

username

Имя пользователя.

password

Пароль пользователя.

grant_type

password

client_id

visiology_api

Для отправки запроса нажмите Send в правом верхнем углу окна:

token.png

Если вам не удается получить токен доступа, обратитесь за помощью к глобальному администратору платформы.

Полученный токен необходимо ввести при авторизации на странице

http(s)://{domain_name}/v3/api/v1/swagger/index.html

Для этого сделайте следующее:

  1. Скопируйте полученный вами токен аутентификации.

  2. Перейдите на страницу документации API по адресу
    http(s)://{domain_name}/v3/api/v1/swagger/index.html

  3. В правом верхнем углу страницы нажмите кнопку Authorize:

    authorize.png

     

  4. В открывшемся окне введите слово Bearer, поставьте один пробел и вставьте скопированный токен. Затем нажмите кнопку Authorize:

    authorize2.png

Срок действия токена составляет 10 минут. По истечении указанного срока потребуется повторить процедуру получения нового токена и повторной авторизации.


Смотрите также

Smart Forms API

Нужна дополнительная помощь?

Свяжитесь с технической поддержкой.