# 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="<https://1678134054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhFCxk-CGTi58SnunJz%2Fuploads%2Fh5pBdhr45HEAfCu61Gey%2FFMS%20v1.1(POSTMAN_INSOMNIA).zip?alt=media&token=55991e44-3b11-48af-ab9f-e3fb3f6998be>" %}

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

![Postman params for queries](https://1678134054-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LhFCxk-CGTi58SnunJz%2F-MKkHuFR9tPezrCMySdv%2F-MKkI8A6oahecVQxan4X%2FNEkvdNNRxj.png?alt=media\&token=4f64d0a2-f0a5-437d-bde4-497dc641af04)

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