
Ważne: integracje z User API przestaną działać od 1 stycznia 2027 roku
Wyłączamy User API — stare API FoodSoul, za pomocą którego wcześniej zmieniano statusy zamówień, aktualizowano ceny i strefy dostaw oraz zarządzano kurierami. Od dawna nie jest ono już rozwijane: wszystkie nowe funkcje dodajemy do CRM API.
Jeśli Twoja integracja działa przez User API, należy ją przenieść na CRM API do 1 stycznia. W przeciwnym razie po tej dacie FoodSoul będzie zwracać błąd na wszystkie jej zapytania. Jak przygotować się do przejścia, opisujemy poniżej.
Jak sprawdzić integrację
Sprawdzić, czy Twoja integracja działa przez User API, może programista. Taka integracja wysyła zapytania na adresy w formacie:
- https://foodsoul.ru/api/user/v1/ (a także by.) — pierwsza wersja;
- https://foodsoul.ru/api/user/v2/ (a także by.) — druga wersja.
Jeśli nie masz pewności, zapytaj osobę obsługującą Twoją integrację lub napisz do wsparcia technicznego.
Co daje przejście
CRM API potrafi znacznie więcej niż User API: umożliwia pracę z zamówieniami i ich kartami, menu, listą stop i stanami magazynowymi, klientami, promocjami oraz raportami.
Warto osobno wspomnieć o webhookach. Dzięki nim CRM samodzielnie informuje Twój system o zdarzeniach — na przykład o nowym zamówieniu lub zmianie statusu — i integracja nie musi stale odpytywać API.
Kolejna zaleta to oddzielne tokeny dostępu. Każdej integracji można przydzielić własny token z odpowiednimi uprawnieniami, a w razie potrzeby w każdej chwili go zablokować lub usunąć.
Jak przejść
- Utwórz token API w CRM: „Integracje” → „Tokeny dostępu do API”. Zapisz go od razu: token jest wyświetlany tylko raz, podczas tworzenia.
- Przekaż token i link do dokumentacji CRM API swojemu programiście.
- Programista przeniesie integrację na CRM API. Sama zmiana adresu nie wystarczy: akcja jest teraz określana w URL zapytania, a lista przekazywanych pól w zapytaniach i odpowiedziach uległa zmianie.
Przypominamy, że należy to zrobić do 1 stycznia 2027 roku.
Pełna dokumentacja CRM API znajduje się na portalu FoodSoul: docs.foodsoul.ru. Jeśli potrzebujesz pomocy przy przejściu, napisz do wsparcia technicznego.
Z poważaniem, zespół FoodSoul! Pracujemy dla Ciebie!