
Маңызды: User API арқылы интеграциялар 2027 жылдың 1 қаңтарынан бастап жұмысын тоқтатады
Біз User API-ді өшіреміз — бұл FoodSoul-дың ескі API-і, бұрын тапсырыстардың статустарын өзгертуге, бағалар мен жеткізу аудандарын жаңартуға, курьерлерді басқаруға қолданылған. Ол көптен бері жаңартылмайды: барлық жаңа мүмкіндіктерді біз CRM API-ге қосамыз.
Егер сіздің интеграцияңыз User API арқылы жұмыс істесе, оны 1 қаңтарға дейін CRM API-ге көшіру қажет. Әйтпесе, осы күннен кейін FoodSoul барлық сұраныстарға қате қайтарады. Өтуді қалай дайындау керек екенін төменде түсіндіреміз.
Интеграцияны қалай тексеруге болады
Сіздің интеграцияңыз User API арқылы жұмыс істей ме, жоқ па, оны әзірлеуші тексере алады. Мұндай интеграция келесі мекенжайларға сұраныс жібереді:
- https://foodsoul.ru/api/user/v1/ (сондай-ақ by.) — бірінші нұсқа;
- https://foodsoul.ru/api/user/v2/ (сондай-ақ by.) — екінші нұсқа.
Егер сенімді болмасаңыз, интеграцияңызды кім қызмет көрсететінін сұраңыз немесе қолдау қызметіне жазыңыз.
Өтудің артықшылықтары
CRM API User API-ге қарағанда әлдеқайда көп мүмкіндіктерге ие: онда тапсырыстар мен олардың карточкаларымен, мәзірмен, стоп-листпен және қалдықтармен, клиенттермен, акциялармен және есептермен жұмыс істеуге болады.
Вебхуктар туралы бөлек айту керек. Олардың көмегімен CRM жүйесі сіздің жүйеңізге оқиғалар туралы өзі хабарлайды — мысалы, жаңа тапсырыс немесе статус өзгерісі туралы, — және интеграцияға API-ді үнемі сұраудың қажеті жоқ.
Тағы бір артықшылығы — жеке қолжетімділік токендері. Әр интеграцияға қажетті құқықтары бар жеке токен беруге болады, қажет болған жағдайда оны кез келген уақытта бұғаттауға немесе өшіруге болады.
Қалай өтуге болады
- CRM-де API токенін жасаңыз: “Интеграциялар” → “API-ге қолжетімділік токендері”. Оны бірден сақтап алыңыз: токен тек бір рет, жасалған кезде ғана көрсетіледі.
- Токен мен CRM API құжаттамасына сілтемені әзірлеушіңізге беріңіз.
- Әзірлеуші интеграцияны CRM API-ге көшіреді. Тек мекенжайды ауыстыру жеткіліксіз: енді әрекет сұраныс URL-інде көрсетіледі, ал сұраныстар мен жауаптардағы берілетін өрістер тізімі өзгерді.
Естеріңізге саламыз, мұны 2027 жылдың 1 қаңтарына дейін жасау қажет.
CRM API-дің толық құжаттамасы FoodSoul порталында: docs.foodsoul.ru. Егер өтуде көмек қажет болса, қолдау қызметіне жазыңыз.
Құрметпен, FoodSoul командасы! Біз сіз үшін жұмыс істейміз!