iiko Cloud API
Woo2iiko работает с iiko Cloud API — официальным облачным API iiko (Syrve).
Базовый URL
| Настройка | Значение по умолчанию |
|---|---|
iiko_api_url | https://api-ru.iiko.services/api/1/ |
Региональные URL
Для других регионов iiko может использоваться другой URL. По умолчанию — российский инстанс. Меняйте только если iiko явно указал иной endpoint.
Авторизация
Два способа (см. Подключение к iiko):
| Способ | Получение токена |
|---|---|
| Token broker | Через сервер woo2iiko по license key (рекомендуется). |
| Legacy API key | Прямой API-ключ iiko Cloud. |
Токен автоматически обновляется при истечении.
Основные операции
| Операция | API-метод | Назначение |
|---|---|---|
| Номенклатура | get_nomenclature | Каталог (категории, товары, модификаторы). |
| Stop-list | get_stop_lists | Остатки по терминалу. |
| Зоны доставки | get_delivery_restrictions | Полигоны и ограничения. |
| Создание доставки | OrderDeliveryRequest | Экспорт заказа доставки. |
| Создание заказа стола | OrderTableRequest | Экспорт заказа стола. |
| Информация о заказе | get_orders_info | Статус заказа. |
| Программы лояльности | loyalty API | Бонусы iiko Card. |
| Скидки | get_discounts | Купоны. |
| Терминалы | /delivery_restaurants | Точки продаж. |
| Города/улицы (legacy) | /cities, /streets | Справочники. |
Вебхуки iiko → сайт
iiko может присылать события на сайт:
| Событие | Что делает плагин |
|---|---|
StopListUpdate | Обновляет стоп-лист → iiko_stoplist_webhook_update. |
DeliveryOrderUpdate | Обновляет статус заказа. |
DeliveryOrderError | Логирует ошибку заказа. |
Endpoint: POST /wp-json/woo2iiko/v1/callback. Авторизация: заголовок authorization = iiko_auth_key.
→ Вебхуки
Таймауты
| Настройка | По умолчанию |
|---|---|
iiko_request_timeout | 15 сек |
Кеширование ответов
iiko API-ответы кешируются для снижения нагрузки:
- Номенклатура →
trs_cache. - Stop-list →
ApiTransientCache(ключStopList). - Терминалы → transient.
Лимиты и rate-limit
iiko Cloud имеет лимиты запросов. Плагин:
- Кеширует ответы (минимум обращений).
- Smart-импорт по revision (импортит только изменения).
- Имеет backoff при синхронизации legacy-справочника (
iiko_geo_legacy_sync_rate_limit_backoff, 60 + случайные секунды).