Dodo IS API: GET /units — Информация о заведениях

Scope: shared.

Параметр	Где	Тип	Обяз.	Описание
countryId	query	string	да	Страна в формате ISO 3166-1 alpha-2
businessId	query	string	да	ID бизнеса (UUID)
unitTypes	query	string	нет	Типы заведений
unitStates	query	string	нет	Состояние заведения
units	query	string	нет	Заведения (UUID)
organizations	query	string	нет	Организации (UUID)
skip	query	integer	нет	Сколько записей пропустить, по умолчанию 0
take	query	integer	нет	Сколько записей выбрать, по умолчанию 100, максимум 1000

Базовые URL

• Боевой (Россия, Додо Пицца): https://api.dodois.io/dodopizza/ru
• Боевой (Россия, Drinkit): https://api.dodois.io/drinkit/ru
• Тестовый (mock-сервер): https://stoplight.io/mocks/dodo-brands/dodo-is/51665679
• Для других стран: https://api.dodois.io/dodopizza/{kz,by,kg,uz,tj}

Авторизация

Тип: OAuth 2.0

OAuth 2.0 Authorization Code. Приложение создаётся в личном кабинете разработчика; токен передаётся в заголовке Authorization: Bearer <token>.

• Авторизация: https://auth.dodois.io/connect/authorize
• Токен и обновление: https://auth.dodois.io/connect/token

Основные scopes: shared, orders, accounting:read, deliverystatistics, sales, stopsales, staffmembers:read, staffshifts:read, unit:read, user.role:read, offline_access (получение refresh_token).

Нюансы

• Постраничные методы: увеличивайте skip на число полученных записей, пока в ответе не придёт isEndOfListReached = true.
• Списки UUID (units и др.) — через запятую без пробелов; во многих методах не больше 30 заведений за запрос.
• Доступ к данным ограничен ролями пользователя и его заведениями — scope user.role:read нужен почти везде.
• Также есть Auth API (заведения и роли пользователя по токену) и Marketplace API (доступ пользователя к платным функциям приложения).
• Статус работы API: https://status.dodois.io/.

Сценарии с этим методом

• Собрать ежедневный отчёт по выручке пиццерий

---

Если этого недостаточно — официальная документация: https://docs.dodois.io/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/dodo-is.md