Аутентификация и авторизация (API версия 2)/uk - История изменений

Administrator в 07:18, 6 февраля 2024

2024-02-06T07:18:00Z

← Предыдущая		Версия 07:18, 6 февраля 2024
Строка 52:		Строка 52:

	У разі зазначення неправильного імені користувача або пароля, ви отримаєте таку відповідь		У разі зазначення неправильного імені користувача або пароля, ви отримаєте таку відповідь
	* Status Code: ~~401 Unauthorized~~		* Status Code: 412 Precondition Failed
	* Body:		* Body:
	<pre>		<pre>
	{		{
	"code": ~~401~~,		"code": 412,
	"message": {		"message": "Некоректні дані користувача. Перевірте коректність введених даних і спробуйте ще раз."
	~~"status": "401 Unauthorized~~",
	"~~message": "Bad credentials, please verify that your login/password are correctly set"~~
	}
	}		}
	</pre>		</pre>

Administrator: Новая страница: «з якого необхідно витягти поля
'''''token''''' – токен, буде потрібно для авторизації при вик...»

2021-06-04T13:15:45Z

Новая страница: «з якого необхідно витягти поля<br> '''''token''''' – токен, буде потрібно для авторизації при вик...»

← Предыдущая		Версия 13:15, 4 июня 2021
Строка 15:		Строка 15:
	'''''Email''''' - логін користувача <br>		'''''Email''''' - логін користувача <br>
	'''''Password''''' - пароль користувача <br>		'''''Password''''' - пароль користувача <br>
	'''''Browser_fingerprint''''' - підпис браузера, для API використовуйте будь-яку унікальну ~~рядок~~ довжиною не більше 128 символів. Ми, наприклад, використовуємо хеш md5();<br>		'''''Browser_fingerprint''''' - підпис браузера, для API використовуйте будь-яку унікальну строку довжиною не більше 128 символів. Ми, наприклад, використовуємо хеш md5();<br>


Строка 86:		Строка 86:
	== Оновлення простроченого token-у ==		== Оновлення простроченого token-у ==

	~~<div lang="ru" dir="ltr" class="mw-content-ltr">~~		У разі закінчення терміну дії token-а, ви отримаєте таку відповідь
	~~В случае окончания срока действия~~ token-а, ~~вы получите следующий ответ~~
	* Status Code: 401 Unauthorized		* Status Code: 401 Unauthorized
	* Body:		* Body:
Строка 96:		Строка 95:
	}		}
	</pre>		</pre>
	Для ~~обновления значения просроченного~~ token-а ~~необходимо выполнить запрос~~ POST ~~запрос~~ на URI
			Для поновлення значення простроченого token-а необхідно виконати запит POST запит на URI
	<pre>		<pre>
	https://order24-api.utr.ua/api/token/refresh		https://order24-api.utr.ua/api/token/refresh
	</pre>		</pre>
	~~передав~~ в ~~теле запроса значение~~ '''''refresh_token''''', ~~полученный ранее~~:		передавши в тілі запиту значення '''''refresh_token''''', отриманий раніше:
	<pre>		<pre>
	{		{
Строка 107:		Строка 107:
	}		}
	</pre>		</pre>
	~~</div>~~

	~~<div lang="ru" dir="ltr" class="mw-content-ltr">~~		Де:<br>
	~~Где~~:<br>		'''''refresh_token''''' – рефреш токен отриманий раніше.<br>
	'''''refresh_token''''' – рефреш токен ~~полученный ранее~~.<br>		'''''browser_fingerprint''''' – підпис браузера, строка повинна бути аналогічна тій яка використовувалася при авторизації.<br>
	'''''browser_fingerprint''''' – ~~подпись~~ браузера, строка ~~должна быть аналогичная той которая использовалась~~ при ~~авторизации~~.<br>
	~~</div~~>

	~~<div lang="ru" dir="ltr" class="mw-content-ltr">~~		На відправлений запит буде отримана відповідь в json-форматі:
	На ~~отправленный запрос будет получен ответ~~ в json-~~формате~~:
	<pre>		<pre>
	{		{
Строка 124:		Строка 120:
	}		}
	</pre>		</pre>
	При ~~отсутствии или указании неверного значения~~ '''''refresh_token''''', ~~вы получите следующий ответ~~		При відсутності або вказівці невірного значення '''''refresh_token''''', ви отримаєте таку відповідь
	* Status Code: 401 Unauthorized		* Status Code: 401 Unauthorized
	* Body:		* Body:
Строка 136:		Строка 132:
	}		}
	</pre>		</pre>
	~~</div>~~

Administrator: Новая страница: «Обов'язково надсилайте заголовок '''''Content-Type''''':

 Content-Type: application/json

2021-06-04T13:07:54Z

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

Новая страница

<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: 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-у ==

<div lang="ru" dir="ltr" class="mw-content-ltr">
В случае окончания срока действия 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>
</div>

<div lang="ru" dir="ltr" class="mw-content-ltr">
Где:<br>
'''''refresh_token''''' – рефреш токен полученный ранее.<br>
'''''browser_fingerprint''''' – подпись браузера, строка должна быть аналогичная той которая использовалась при авторизации.<br>
</div>

<div lang="ru" dir="ltr" class="mw-content-ltr">
На отправленный запрос будет получен ответ в 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>
</div>

Аутентификация и авторизация (API версия 2)/uk - История изменений

Administrator в 07:18, 6 февраля 2024

Administrator: Новая страница: «з якого необхідно витягти поля '''''token''''' – токен, буде потрібно для авторизації при вик...»

Administrator: Новая страница: «Обов'язково надсилайте заголовок '''''Content-Type''''': Content-Type: application/json »

Administrator: Новая страница: «з якого необхідно витягти поля
'''''token''''' – токен, буде потрібно для авторизації при вик...»

Administrator: Новая страница: «Обов'язково надсилайте заголовок '''''Content-Type''''':
Content-Type: application/json
»