Изменения

Перейти к навигации Перейти к поиску

API Authorization

229 байт добавлено, 02:51, 17 февраля 2024
''Данный документа описывает метод авторизации поставщика/дистрибьютора в системе Smart Satu.''
Авторизация пользователя в систему Smart Satu происходит путем отправки POST-запроса с логином и паролем пользователя в JSON-теле по URL: https://food.smartsatu.com/api/users/login. Headers в данном запросе не обрабатываются и могут быть пустымии должны содержать: "content-type: application/json; charset=utf-8" и "country: ru".  Далее на стороне сервера происходит валидация данных пользователя. В случае корректности данных сервер выдает JSON-тело ответа, которое содержит данные пользователя с уникальным токеном авторизации, который в дальнейшем будет использоваться в каждом последующем запросе к системе Smart Satu.
'''Версия'''
'''URI схема'''
''Host : //login.smartsatu.com/api/user/  Schemes login  Schemes : HTTPS''
==Методы==
'''Авторизация пользователя'''
POST /api/user/login 
===Описание===
Метод для авторизации пользователя в системе Smart Satu.
Для авторизации необходимо воспользоваться выданным логином и паролем для системы заказов Smart Satu. В ответ на запрос авторизации приходит параметр - access_token_expiration_time, который в себе содержит unixtime время, когда токен станет недействителен. Рекомендуемый порядок Порядок работы с токеном выглядит следующим образом:
# После получения токена необходимо сохранить время его истечения.
# Перед каждым запросом нужно проводить проверку, чтобы текущее время было меньше времени истечения жизни токена.
'''Возвращаемые ресурсом типы MIME'''
*application/json
 
==Определения==
===Login===
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | loginusername
| Логин
| string
| string
| qwerty
|-
| style="font-weight:bold;" | direction
| Идентификатор сервера
| string
| food (Запросить у Smart Satu)
|}
{
"username" : "supplier",
"password" : "qwerty", "direction" : "food"
}

Навигация