
Important : les intégrations avec l'API utilisateur cesseront de fonctionner à partir du 1er janvier 2027
Nous désactivons l’User API — l’ancienne API de FoodSoul, qui permettait auparavant de modifier les statuts des commandes, de mettre à jour les prix et les zones de livraison, ainsi que de gérer les coursiers. Cette API n’est plus mise à jour depuis longtemps : toutes les nouvelles fonctionnalités sont désormais ajoutées à la CRM API.
Si votre intégration fonctionne via l’User API, il est nécessaire de la migrer vers la CRM API avant le 1er janvier. Sinon, après cette date, FoodSoul renverra une erreur à toutes ses requêtes. Nous expliquons ci-dessous comment préparer cette transition.
Comment vérifier votre intégration
Un développeur peut vérifier si votre intégration utilise l’User API. Ce type d’intégration envoie des requêtes vers les adresses suivantes :
- https://foodsoul.pro/api/user/v1/ (ainsi que kz. et az.) — première version ;
- https://foodsoul.pro/api/user/v2/ (ainsi que kz. et ua.) — deuxième version.
Si vous n’êtes pas sûr, demandez à la personne qui gère votre intégration ou contactez le support.
Les avantages de la migration
La CRM API offre bien plus de possibilités que l’User API : elle permet de gérer les commandes et leurs fiches, le menu, la liste d’indisponibilité et les stocks, les clients, les promotions et les rapports.
Un mot particulier sur les webhooks. Grâce à eux, la CRM informe directement votre système des événements — par exemple, une nouvelle commande ou un changement de statut — et il n’est plus nécessaire pour l’intégration d’interroger constamment l’API.
Un autre avantage : des jetons d’accès distincts. Chaque intégration peut recevoir son propre jeton avec les droits appropriés, et il est possible de le bloquer ou de le supprimer à tout moment si besoin.
Comment migrer
- Créez un jeton API dans la CRM : “Intégrations” → “Jetons d’accès à l’API”. Sauvegardez-le immédiatement : le jeton n’est affiché qu’une seule fois, lors de sa création.
- Transmettez le jeton et le lien vers la documentation de la CRM API à votre développeur.
- Le développeur migrera l’intégration vers la CRM API. Il ne suffit pas de remplacer l’adresse : l’action est désormais indiquée dans l’URL de la requête, et la liste des champs transmis dans les requêtes et les réponses a changé.
Nous vous rappelons que cette opération doit être effectuée avant le 1er janvier 2027.
La documentation complète de la CRM API est disponible sur le portail FoodSoul : docs.foodsoul.pro. Si vous avez besoin d’aide pour la migration, contactez le support.
Cordialement, l’équipe FoodSoul ! Nous travaillons pour vous !