iikoCloud API: POST /api/v2/access_token — Получение токена

В ответе: correlationId и token.

Параметр	Где	Тип	Обяз.	Описание
apiKey	body	string	да	API-ключ из iikoWeb; определяет доступные организации
appId	body	string	да	ID приложения с портала разработчика (uuid)
clientSecret	body	string	да	Секрет приложения с портала разработчика
Timeout	header	integer	нет	Таймаут в секундах, по умолчанию 15

Базовые URL

• Боевой: https://api-ru.iiko.services

Авторизация

Тип: Bearer-токен

• Зарегистрируйтесь на портале разработчика https://public-api.iikoweb.ru/portal и создайте приложение — получите appId и одноразово показываемый clientSecret.
• В iikoWeb → «Интеграции» → «API-ключи» сгенерируйте apiKey.
• Получите токен методом POST /api/v2/access_token и передавайте его во всех запросах: Authorization: Bearer {token}.

Токен (JWT) действует 1 час; refresh-токена нет — запрашивайте новый до истечения срока. Старый метод POST /api/1/access_token с apiLogin устарел.

Нюансы

• Все запросы, кроме получения токена, требуют заголовок Authorization; в каждом можно передать заголовок Timeout (секунды).
• Методы-команды (создание, отмена, изменение заказов) выполняются асинхронно: в ответе correlationId, итог — через /api/1/commands/status.
• Форматы: uuid — строка UUID; дата-время — yyyy-MM-dd HH:mm:ss.fff без часового пояса, локальное время терминала.
• Методы сгруппированы по группам ограничений (Data: dictionaries, Data: menu, Orders: creating и др.) — права API-ключа настраиваются по этим группам.
• Часть полей доступна только с определённой версии iikoRMS (в документации — пометки «Allowed from version»).
• Устаревшие методы: /api/1/access_token, /api/1/nomenclature, /api/2/menu/by_id — используйте /api/v2/access_token и /api/menu/v3/by_id.

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

• Подключиться и найти свои рестораны

---

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