Rentu для разработчиков

С чего начать#

Быстрый стартПервый запрос за пять минут: ключ → токен → данные Доступ и ключиКому выдаётся ключ и как он связан с правами сотрудника ТарифыЧто даёт Basic и за что берут деньги на PRO Типовые сценарииГотовые последовательности запросов под частые задачи Готовые клиентыPython, 1С и коллекция Postman Частые ошибкиГде чаще всего расходятся цифры

Что можно забрать#

ПродажиВыручка, чеки и товарооборот по дням и месяцам ЧекиПочековая выгрузка с позициями и реквизитами кассы ПосещаемостьПроходимость ТЦ и зон по дням и часам АномалииОтклонения в продажах, которые нашла платформа КассыСостояние подключения, смены и сроки ФН СобытияАкции и ремонты в календаре центра

Что можно передать#

ТоварооборотСдача оборота точками без кассы ПосещаемостьДанные собственных счётчиков ТЦ СобытияПубликация акций в календарь

Основы#

Базовые вещи, которые действуют на всех методах: как получить токен, как устроен конверт ответа, какие бывают ошибки, как считаются лимиты и в какой зоне трактуются даты.

Авторизацияclient_credentials и Bearer-токен на час Запросы и ответыБазовый URL, заголовки, единый конверт ОшибкиМашинные коды и что с ними делать ЛимитыЧастота считается по торговому центру ПагинацияТолько там, где список может быть большим Даты и таймзоныГраницы суток — в зоне торгового центра

Что стоит знать заранее#

Ключ принадлежит сотруднику, а не системе. Доступ к торговому центру определяется ролями этого сотрудника. Сняли роль, и центр пропал из выдачи; отдельно отзывать ключ не нужно. Подробнее в разделе Доступ и ключи.

Тариф закреплён за торговым центром, а не за ключом. Один ключ может покрывать несколько центров на разных тарифах: по одному доступен год истории, по другому только месяц. Подробнее в разделе Тарифы.

Частота считается по торговому центру. Сотрудники одного центра делят общий лимит, так что пять аккаунтов не дадут пятикратной скорости. Подробнее в разделе Лимиты.

Это документация версии 2. Токены v1 и v2 несовместимы в обе стороны, методы и форматы ответов различаются. Интеграции, сделанные раньше и использующие api-token, работают с v1.