# 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 %}


---

# 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://fms-api.petroline.net.ua/master.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.