Перейти к содержимому

Авторизация пользователя

Получение авторизационного токена АТОЛ Онлайн v5 - методы POST и GET getToken, время жизни 24 часа.

Для отправки чеков через API необходимо получить авторизационный токен. Токен дает доступ к системе в течение 24 часов с момента формирования и передается во все методы API (заголовок Token или параметр строки запроса token). Максимальная длина токена - 1000 символов.

Повторный запрос токена

Если в течение 24 часов запросить токен повторно, вы получите либо новый токен (время жизни 24 часа), либо ранее выданный (24 часа с момента первой выдачи). Количество одновременно действующих токенов равно количеству реплик сервиса. Рекомендуется запрашивать новый токен только при получении ошибки ExpiredToken (код 11).

Запрос

POST

http
POST https://online.atol.ru/possystem/v5/getToken
Content-Type: application/json; charset=utf-8
json
{
  "login": "netest",
  "pass": "********"
}

GET (альтернатива)

http
GET https://online.atol.ru/possystem/v5/getToken?login=<login>&pass=<pass>
ПараметрОписаниеОбяз.
loginЛогин из файла настроек интеграции в личном кабинетеДа
passПароль из файла настроек интеграции в личном кабинетеДа
sourceНазвание интегратора, через которого отправляются запросы (до 100 символов)Нет

Ответ

json
{
  "error": null,
  "token": "fj45u923j59ju42395iu9423i59243u0",
  "timestamp": "30.11.2020 17:58:53"
}
json
{
  "error": {
    "error_id": "4475d6d8d-844d-4d05-aa8b-e3dbdf3defd5",
    "code": 12,
    "text": "Неверный логин или пароль",
    "type": "system"
  },
  "timestamp": "15.02.2020 13:00:31"
}
ПараметрОписание
tokenАвторизационный токен (до 1000 символов). Возвращается только при отсутствии ошибки
timestampДата и время ответа
error.error_idУникальный идентификатор ошибки
error.codeКод ошибки - см. Ошибки сервиса
error.textТекст ошибки
error.typeТип ошибки