Просмотр кода страницы Аутентификация и авторизация (API версия 2)/uk

<languages/>
Для отримання доступу до API, необхідно виконати вхід в свій обліковий запис, виконавши POST запит на URI
<pre>
https://order24-api.utr.ua/api/login_check
</pre>
Передавши в тілі запиту логін, пароль і підпис браузера, наприклад:
<pre>
{
  "email":"test@mail.ua",
  "password":"mysecretpassword",
  "browser_fingerprint": "some-unique-key-here"
}
</pre>
Де: <br>
'''''Email''''' - логін користувача <br>
'''''Password''''' - пароль користувача <br>
'''''Browser_fingerprint''''' - підпис браузера, для API використовуйте будь-яку унікальну строку довжиною не більше 128 символів. Ми, наприклад, використовуємо хеш md5();<br>


Обов'язково надсилайте заголовок '''''Content-Type''''':
<pre>
Content-Type: application/json
</pre>


На відправлений запит буде отримана відповідь в json-форматі:
<pre>
{
    "token": "eyJ0eXAiOiJKV1Q...",
    "expires_at": "2020-01-17 15:04:50",
    "refresh_token": "2a3bb84af9a3..."
}
</pre>

з якого необхідно витягти поля<br>
'''''token''''' – токен, буде потрібно для авторизації при виконанні наступних запитів, має термін дії<br>
'''''refresh_token''''' – токен, який буде потрібний для подальшого оновлення поля token, після закінчення його терміну дії<br><br>

Наприклад, для пошуку деталі по артикулу OC90, посилаємо наступний запит:
<pre>
https://order24-api.utr.ua/api/search/oc90 
</pre>
додавши при цьому в headers<br>
<pre>
Authorization: Bearer eyJ0eXAiOiJKV1Q...<br>
</pre>
Де в '''''Authorization''''' після ключового слова Bearer потрібно передати отриманий вище '''''token'''''. 



== Помилка аутентифікації ==

У разі зазначення неправильного імені користувача або пароля, ви отримаєте таку відповідь
* Status Code:	412 Precondition Failed
* Body:
<pre>
{
    "code": 412,
    "message": "Некоректні дані користувача. Перевірте коректність введених даних і спробуйте ще раз."
}
</pre>
У разі відсутності Authorization або відсутності ключового слова Bearer, ви отримаєте таку відповідь
* Status Code:	401 Unauthorized
* Body:
<pre>
{
    "code": 401,
    "message": "JWT Token not found"
}
</pre>
У разі зазначення неправильного Authorization ви отримаєте таку відповідь
* Status Code:	401 Unauthorized
* Body:
<pre>
{
    "code": 401,
    "message": "Invalid JWT Token"
}
</pre>



== Оновлення простроченого token-у ==

У разі закінчення терміну дії token-а, ви отримаєте таку відповідь
* Status Code:	401 Unauthorized
* Body:
<pre>
{
    "code": 401,
    "message": "Expired JWT Token"
}
</pre>

Для поновлення значення простроченого token-а необхідно виконати запит POST запит на URI
<pre>
https://order24-api.utr.ua/api/token/refresh
</pre>
передавши в тілі запиту значення '''''refresh_token''''', отриманий раніше:
<pre>
{
    "refresh_token": "2a3bb84af9a3...",
    "browser_fingerprint": "some-unique-key-here"
}
</pre>

Де:<br>
'''''refresh_token''''' – рефреш токен отриманий раніше.<br>
'''''browser_fingerprint''''' – підпис браузера, строка повинна бути аналогічна тій яка використовувалася при авторизації.<br>

На відправлений запит буде отримана відповідь в json-форматі:
<pre>
{
    "token": "eyJ0eXAiOiJKV1Q...",
    "expires_at": "2020-01-17 15:14:50",
    "refresh_token": "2a3bb84af9a3..."
}
</pre>
При відсутності або вказівці невірного значення '''''refresh_token''''', ви отримаєте таку відповідь 
* Status Code:	401 Unauthorized
* Body:
<pre>
{
    "code": 401,
    "message": {
        "status": "401 Unauthorized",
        "message": "Bad credentials, please verify that your login/password are correctly set"
    }
}
</pre>