
Wichtig: Integrationen mit der User API werden ab dem 1. Januar 2027 nicht mehr funktionieren
Wir schalten die User API ab – die alte API von FoodSoul, über die früher Bestellstatus geändert, Preise und Liefergebiete aktualisiert und Kuriere verwaltet wurden. Sie wird schon lange nicht mehr aktualisiert: Alle neuen Funktionen fügen wir in die CRM API ein.
Wenn Ihre Integration über die User API läuft, muss sie bis zum 1. Januar auf die CRM API umgestellt werden. Andernfalls wird FoodSoul nach diesem Datum auf alle Anfragen dieser Integration mit einem Fehler antworten. Wie Sie sich auf den Umstieg vorbereiten, erklären wir unten.
Wie Sie Ihre Integration überprüfen
Ob Ihre Integration über die User API läuft, kann Ihr Entwickler prüfen. Eine solche Integration sendet Anfragen an folgende Adressen:
- https://foodsoul.ru/api/user/v1/ (sowie by.) – erste Version;
- https://foodsoul.ru/api/user/v2/ (sowie by.) – zweite Version.
Wenn Sie unsicher sind, fragen Sie denjenigen, der Ihre Integration betreut, oder wenden Sie sich an den Support.
Vorteile des Umstiegs
Die CRM API kann deutlich mehr als die User API: Sie ermöglicht die Arbeit mit Bestellungen und deren Karten, dem Menü, der Stoppliste und Lagerbeständen, Kunden, Aktionen und Berichten.
Besonders erwähnenswert sind die Webhooks. Damit informiert das CRM Ihr System selbstständig über Ereignisse – zum Beispiel über eine neue Bestellung oder eine Statusänderung – und die Integration muss die API nicht ständig abfragen.
Ein weiterer Vorteil sind separate Zugriffstoken. Für jede Integration kann ein eigener Token mit den benötigten Rechten ausgestellt werden, der bei Bedarf jederzeit gesperrt oder gelöscht werden kann.
So gelingt der Umstieg
- Erstellen Sie ein API-Token im CRM: „Integrationen“ → „API-Zugriffstoken“. Speichern Sie es sofort ab: Das Token wird nur einmal, bei der Erstellung, angezeigt.
- Geben Sie das Token und den Link zur CRM API-Dokumentation an Ihren Entwickler weiter.
- Der Entwickler stellt die Integration auf die CRM API um. Ein reiner Adresswechsel reicht nicht aus: Die Aktion wird jetzt in der URL der Anfrage angegeben, und die Liste der übermittelten Felder in Anfragen und Antworten hat sich geändert.
Bitte denken Sie daran, dies bis zum 1. Januar 2027 zu erledigen.
Die vollständige Dokumentation zur CRM API finden Sie im FoodSoul-Portal: docs.foodsoul.ru. Wenn Sie Hilfe beim Umstieg benötigen, wenden Sie sich bitte an den Support.
Mit freundlichen Grüßen, Ihr FoodSoul-Team! Wir arbeiten für Sie!