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

<languages/>
<translate>
<!--T:1-->
Для получения доступа к 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:	401 Unauthorized
* Body:
<pre>
{
    "code": 401,
    "message": {
        "status": "401 Unauthorized",
        "message": "Bad credentials, please verify that your login/password are correctly set"
    }
}
</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>

</translate>