> For the complete documentation index, see [llms.txt](https://fms-api.petroline.net.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fms-api.petroline.net.ua/master.md).

# FMS API

{% hint style="info" %}
УВАГА!  АРІ даної версії буде вимкнено  01.02.2027 року!  Для подальшого використання рекомендуємо перехід на АРІ версії 2 - [https://apiv2.petroline.in.ua/swagger/index.html](https://apiv2.petroline.in.ua/swagger/index.html#/)
{% endhint %}

Для використання АРІ достатньо надіслати POST запити на спеціальну адресу сервера.

Відповіді сервера надходять у JSON-форматі. 

Кодування - UTF8. 

У заголовку обов'язково вказати тип даних application/json. 

Форма відправки пакета - довільний рядок (RAW строка) АБО JSON об'єкт, система автоматично обробить дані в залежності від отриманого типу.

Для тестування функціоналу можна використовувати:

* Застосунок  Postman / Hoppscotch / Insomnia або аналоги
* Колекція ендпойнтів:

{% file src="/files/5lMJwpn1QS4EUCO7GBmC" %}

Приклад конфігурації для налагодження через Postman:

![Postman params for queries](/files/-MKkI8A6oahecVQxan4X)

1. Адреса запиту з вказанням методи передачі
2. Вказанния типа даних
3. Параметри запиту

У всіх наступних прикладах для налагодження буде використовуватися:

* Логін - <demo@domain.com>
* Пароль - demo

{% hint style="danger" %}

### Пароль користувача в систему передається в форматі SHA256.

{% endhint %}

При шифруванні пароля "demo" по алгоритму SHA256 отримуємо "2a97516c354b68848cdbd8f54a226a0a55b21ed138e207ad6c5cbb9c00aa5aea" значение.

#### Приклад сформованої строки довільного типу (RAW)

{% code overflow="wrap" %}

```bash
'login=demo@domain.com&pass=2a97516c354b68848cdbd8f54a226a0a55b21ed138e207ad6c5cbb9c00aa5aea&datestart=27.05.2019 00:00:00&datefinish=12.12.2021 23:59:59'
```

{% endcode %}

#### Приклад сформованої строки в форматі JSON

{% code overflow="wrap" %}

```json
{
	"login":"demo@domain.com",
	"pass":"2a97516c354b68848cdbd8f54a226a0a55b21ed138e207ad6c5cbb9c00aa5aea",
	"datestart":"27.05.2019 00:00:00",
	"datefinish":"12.12.2021 23:59:59"
}
```

{% endcode %}