
Важно: интеграции на User API перестанут работать с 1 января 2027 года
Мы отключаем User API — старый API FoodSoul, через который раньше меняли статусы заказов, обновляли цены и районы доставки, управляли курьерами. Он давно не обновляется: все новые возможности мы добавляем в CRM API.
Если ваша интеграция работает через User API, её нужно перевести на CRM API до 1 января. Иначе после этой даты FoodSoul будет отвечать ошибкой на все её запросы. Как подготовиться к переходу, рассказываем ниже.
Как проверить интеграцию
Проверить, работает ли ваша интеграция через User API, может разработчик. Такая интеграция отправляет запросы на адреса вида:
- https://foodsoul.ru/api/user/v1/ (а также by.) — первая версия;
- https://foodsoul.ru/api/user/v2/ (а также by.) — вторая версия.
Если не уверены, спросите у того, кто обслуживает вашу интеграцию, или напишите в поддержку.
Что даёт переход
CRM API умеет гораздо больше, чем User API: в нём можно работать с заказами и их карточками, меню, стоп-листом и остатками, клиентами, акциями и отчётами.
Отдельно стоит сказать о вебхуках. С ними CRM сама сообщает вашей системе о событиях — например, о новом заказе или смене статуса, — и интеграции не нужно постоянно опрашивать API.
Ещё одно преимущество — отдельные токены доступа. Каждой интеграции можно выдать свой токен с нужными правами, а при необходимости в любой момент заблокировать или удалить его.
Как перейти
- Создайте API-токен в CRM: “Интеграции” → “Токены доступа к API”. Сразу сохраните его: токен показывается только один раз, при создании.
- Передайте токен и ссылку на документацию CRM API вашему разработчику.
- Разработчик перенесёт интеграцию на CRM API. Одной замены адреса недостаточно: действие теперь указывается в URL запроса, а список передаваемых полей в запросах и ответах изменился.
Напоминаем, что сделать это нужно до 1 января 2027 года.
Полная документация CRM API — на портале FoodSoul: docs.foodsoul.ru. Если нужна помощь с переходом, напишите в поддержку.
С Уважением, команда FoodSoul! Мы работаем для Вас!