Авторизація

Запит токену для авторизації

URI: /api/v2/authenticate

Метод використовується на початку зміни для авторизації за логіном і паролем від CashDesk. Для використання даного запиту потрібно пройти реєстрацію на сайті.

Запит виконується методом POST у json форматі з даними.

⚠️ Запит повинен містити заголовки Accept: application/json та Content-Type: application/json

У відповідь на даний запит ви отримаєте тимчасовий API токен (OAuth) у форматі Authorization: Bearer.

Після успішної авторизації в особистому кабінеті вам необхідно згенерувати постійний API ключ.

Параметри запиту

Ім'я	Тип	Обов'язковий	Опис
email	string	Так	Електронна пошта співробітника (логін для авторизації в CashDesk)
password	string	Так	Пароль співробітника для авторизації в CashDesk

Приклад запиту

Запит: /api/v2/authenticate

{
    "email": "[email protected]",
    "password": "secret"
}

Параметри відповіді

Ім'я	Тип	Опис
active_rro	boolean	Користувач має активні каси
developer_id	integer	Назва платформи або компанії
opened_shift	integer	Відкрита зміна
token	string	Тимчасовий токен авторизації
token_expires_at	string	Строк валідності токену
user	object	Параметри користувача
user.full_name	string	Повне ім’я користувача
user.uuid	string	Унікальний ідентифікатор користувача
user.email	string	Електронна пошта користувача
user.edrpou	string	Номер ЄДРПОУ користувача
user.drfo	string	Реєстраційний номер облікової картки платника податків користувача
user.last_online	string	Дата останнього запиту до сервера поточним користувачем
user.subject_key_id	string	Публічний ключ КЕП користувача

Приклад успішної відповіді

Успішна авторизація

200 OK

Відповідь: /api/v2/authenticate

{
    "active_rro": false,
    "developer_id": null,
    "opened_shift": "4000055255",
    "token": "Bearer eyJ0eXAiOiJKV1Q....",
    "token_expires_at": "08.07.2023 11:25",
    "user": {
        "full_name": "Іванов Іван Іванович",
        "uuid": "67***49dd-bcc7-e4631977a386",
        "email": "[email protected]",
        "edrpou": "34***362",
        "drfo": "103***2014",
        "last_online": "11-08-2020 17:15:31",
        "subject_key_id": "88b920a191b2402e86f5f***f78735b0d9734b7266b80f156",
        "signature": {
            "serial": "14F***0700000000000000000000000000000001",
            "cert_end_data": "15.11.2023"
        }
    }
}

порада

Postman колекція (Вхід по email/пароль): https://https://documenter.getpostman.com/view/12128952/TVRj5U1d#37243911-b0c1-4ebf-ad27-b57734cc2c4b