# Hideez Enterprise Server як web API

Майже все, що ви можете робити з веб-інтерфейсом HES, ви можете робити через виклики HES REST API

Дотримуйтесь інструкції `Quick Start` :

Веб-API HES призначений для інтеграції служби автентифікації Hideez зі сторонніми службами. Використовуючи API, ви можете керувати співробітниками, пристроями та обліковими даними. Майже все, що ви можете робити з веб-інтерфейсом HES, ви можете робити через виклики HES REST API. Щоб переглянути список доступних методів, їхні параметри та значення, що повертаються, вам потрібно встановити власний екземпляр HES і відкрити посилання:

&#x20;`https://<your_server_name>/swagger/`&#x20;

За цим посиланням ви також зможете перевірити кожен метод. Щоб використовувати виклики веб-API із зовнішньої програми чи служби, вам потрібно спочатку авторизуватися. Використовуйте метод  `POST` `https://<your_server_name>/api/Identity/LoginWithPassword` і надішліть свій логін (email) і пароль у форматі json.

```
{
    "email": "<user_email>",
    "password": "<user_password>"
}
```

Заголовки відповідей від сервера міститимуть файл cookie під назвою ".AspNetCore.Identity.Application". Додайте цей файл cookie до заголовків кожного наступного запиту. Файл cookie ідентифікації дійсний протягом двох тижнів, після чого вам потрібно знову запитати метод:

&#x20; `https://<your_server_name>/api/Identity/LoginWithPassword`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://enterprise-ua.hideez.com/api/untitled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.