API-ის ვერსიები და გამორთვის თარიღები: რატომ არ არის ინტეგრაცია მუდმივი და რას ვწერ კალენდარში

ამ კვირაში რამდენიმე პროვაიდერმა ერთბაშად შეგვახსენა, რომ სხვისი API-ით ინტეგრაცია იმდენ ხანს ცოცხლობს, რამდენ ხანსაც პროვაიდერი ძველ ვერსიას ინახავს. Weaviate-მა GraphQL-ის გამორთვის თარიღი დაასახელა. Meta-მ HighLevel-ის მეშვეობით გამოაცხადა, რომ WhatsApp-ის მარკეტინგული შეტყობინებები Cloud API-ით 2027 წლის ოქტომბერში დასრულდება. Twilio-მ ვებჰუკების პარამეტრების API გამოუშვა, Shopify-მ კი Hydrogen ბიბლიოთეკად აქცია. ბიზნესის მფლობელისთვის ეს მნიშვნელოვანია: საიტიდან განაცხადები და კლიენტებისთვის შეტყობინებები ასეთ კავშირებზე გადის, და როცა პროვაიდერი ვერსიას თიშავს, ისინი თქვენს CRM-ში უბრალოდ წყვეტენ მოსვლას, ყოველგვარი გაფრთხილების გარეშე.

რა გამოვიდა

n8n-მა 22 ოქტომბერს დაალაგა, როგორ აღნიშნავენ პროვაიდერები API-ის ვერსიებს: URL-ის გზაში, მაგალითად /v1/products, HTTP-სათაურში, გამოშვების თარიღით ან მოთხოვნის პარამეტრით. ინტეგრაციისთვის მნიშვნელოვანია, იცოდე, სად არის ვერსია მითითებული და როგორ შეამჩნიო, რომ მისი დრო მთავრდება. სათაური deprecation ამბობს, რომ ვერსია ექსპლუატაციიდან გამოდის, სათაური sunset ზუსტ თარიღს იძლევა, მის შემდეგ კი პროვაიდერს შეუძლია 410 Gone-ით უპასუხოს.

Weaviate-მა 26 ოქტომბერს გამოაცხადა, რომ GraphQL, მისი პირველი მოთხოვნების API, ექსპლუატაციიდან გამოდის. ამ დღეს არაფერი ფუჭდება. Weaviate Cloud-ის კლასტერებს, რომლებსაც GraphQL ბოლო 30 დღის განმავლობაში არ გამოუყენებიათ, 2026 წლის 1 დეკემბერს გამორთავენ, დანარჩენებს 2027 წლის 1 მაისს. ახალი კლასტერები უკვე მის გარეშე იქმნება. თუ აპლიკაცია Python-ის, TypeScript-ის, Java-ს ან C#-ის მიმდინარე კლიენტებით მუშაობს, ის, სავარაუდოდ, არ დაზარალდება: ეს კლიენტები gRPC-ით მუშაობენ. მიგრაციის გეგმა ოთხ ნაბიჯად: იპოვოთ /v1/graphql-ის გამოძახებები კოდსა და პროქსებში, აირჩიოთ შემცვლელი, გადაიყვანოთ მოთხოვნები, შეამოწმოთ აპლიკაცია გამორთული GraphQL-ით.

Twilio-მ 15 ოქტომბერს Webhook Configuration API საერთო ხელმისაწვდომობაში გადაიყვანა. მისით თქვენ ადგენთ, როგორ აწერს Twilio ხელს გამავალ ვებჰუკებს და როგორ აწვდის მათ, ცალკე ყოველი URL-ისთვის, ორი რესურსით: Webhook Settings და Webhook Rules. changelog-ის ჩანაწერში მხოლოდ ესაა, დეტალები არ მინახავს.

HighLevel-მა 19 ოქტომბერს Meta-ს გადაწყვეტილება გადმოსცა: 2027 წლის 13 ოქტომბრიდან WhatsApp-ის მარკეტინგული შეტყობინებები Cloud API-ით აღარ მიიტანება. ისინი Marketing Messages API-ით უნდა გაიგზავნოს, რომელსაც HighLevel-ში MM Lite ჰქვია. სერვისული და უტილიტარული შეტყობინებები Cloud API-ზე რჩება. აქტივაციას სუბ-ანგარიშზე რამდენიმე წუთი სჭირდება, შაბლონებსა და ნომრებს HighLevel ისე გადაიტანს, როგორც არის. HighLevel Meta-ს A/B ტესტს იმოწმებს 12 მილიონზე მეტ შეტყობინებაზე: მაღალი ჩართულობის შეტყობინებებისთვის მიწოდება +9 %-მდე იზრდება. ამ ციფრის შემოწმება არ შემიძლია, ის Meta-ს ტექსტიდანაა HighLevel-ის გადმოცემით.

Shopify-მ 14 ოქტომბერს Hydrogen 2026-10 გამოუშვა. ადრე ეს React Router-ზე აგებული ფრეიმვორკი იყო, და მისი კალათის ან ანალიტიკის გამოსაყენებლად ვიტრინა მთლიანად მასზე უნდა აგებულიყო. ახლა ეს ბიბლიოთეკაა ნებისმიერი JavaScript-ფრეიმვორკისთვის: კალათა, ფასები მყიდველის ვალუტაში, Shop Pay და მყიდველის შესვლა. ძველი ვიტრინები მუშაობას აგრძელებს. ივნისიდან, როცა პრევიუ დაიწყო, შვიდი რელიზი გამოვიდა.

რატომ სჭირდება ეს ბიზნესს

ავიღოთ სერვისული კომპანია. საიტიდან განაცხადები CRM-ში მიდის, იქიდან კლიენტს WhatsApp-ით დადასტურება ეგზავნება, ტელეფონიაში კი ზარი ლიდს ქმნის. სამი პროვაიდერი, სამი API ვერსია. წერილი ვერსიის გაუქმებაზე მოდის იმ კონტრაქტორის ფოსტაზე, რომელმაც ინტეგრაცია ორი წლის წინ გააკეთა და დიდი ხანია სხვა რამითაა დაკავებული. გამორთვის დღეს განაცხადები აღარ აღწევს, და ამას პირველი გამყიდველი ამჩნევს, რომლის სამშაბათიც ლიდების გარეშე გავიდა.

დასკვნა: ყოველ ინტეგრაციას უნდა ჰყავდეს მფლობელი და ჰქონდეს ვერსია და თარიღი, რომლამდეც ის ზუსტად მუშაობს. თუ ამ სამიდან ერთი მაინც აკლია, მისი დასასრულის თარიღი უცნობია, და მას ფაქტის შემდეგ გაიგებთ.

როგორ მაქვს ეს მოწყობილი

აშშ-ის PDR-კომპანიაში 2021 წლიდან სერვერის, ტელეფონიის, პარსერებისა და CRM-ის კავშირს ვუძღვები. 2022 წელს გამყიდველების AppSheet-აპლიკაციის ინტეგრაცია GoHighLevel-თან დავწერე, მთელი 2023 წელი კი მას ვხვეწდი, სანამ კომპანია Google Sheets-იდან MariaDB-ზე გადადიოდა და ახალ სერვისებს ერთმანეთის მიყოლებით აერთებდა. შიდა API ამ წლებში მესამე ვერსიამდე მივიყვანე, ასე რომ ვერსიების ცვლას ორივე მხრიდან ვიცნობ: როგორც სხვისი API-ის მომხმარებელი და როგორც საკუთარის ავტორი. იქ სტეკში Twilio და GoHighLevel არის, ამიტომ ამ მიმოხილვის ორივე changelog პირდაპირ მეხება, და გამორთვების კალენდარი ჩემთან მხარდაჭერის ნაწილია.

სამხრეთ აფრიკაში ავტომობილების გაქირავების კომპანიისთვის 2024 წლის ოქტომბრიდან 2025 წლის თებერვლამდე ველების სინქრონიზაციას ვაწყობდი FlutterFlow-ის აპლიკაციას, რომელსაც Firebase-ის ბექენდი აქვს, და AmoCRM-ს შორის. ეს კავშირიც სხვისი API-ის ვერსიაზე ცოცხლობს.

რას გავაკეთებდი

შევადგენდი ინტეგრაციების სიას: პროვაიდერი, ვერსია, სად არის ის მითითებული, ვინ იღებს წერილებს პროვაიდერისგან. ამას ერთი საათი სჭირდება, და ის პირველივე გამორთვაზე ანაზღაურდება.

პროვაიდერების პასუხებში deprecation და sunset სათაურებს ლოგში ჩავწერდი და შეტყობინებას გავგზავნიდი, როცა ისინი გამოჩნდება. ეს სერვერზე ერთი middleware-ია.

410-ს ჩვეულებრივი შეცდომებისგან ცალკე დავამუშავებდი. განმეორებითი ცდები აქ მხოლოდ ლოგს ანაგვიანებს.

ახალ ვერსიას გადართვამდე ცალკე გარემოში შევამოწმებდი. Weaviate გვთავაზობს, სატესტო კლასტერზე GraphQL გამოვრთოთ და ვნახოთ, რა გაფუჭდა.

თარიღებს კალენდარში ახლავე ჩავწერდი: Weaviate-თან 2026 წლის 1 დეკემბერი და 2027 წლის 1 მაისი, Meta-სთან 2027 წლის 13 ოქტომბერი. WhatsApp-ისთვის HighLevel-ში MM Lite-ს ყველაზე დატვირთულ სუბ-ანგარიშზე ჩავრთავდი და მიწოდებას შევამოწმებდი, სანამ ერთი წლის მარაგი გვაქვს.

დაკავშირებული მასალები

იმაზე, როგორ არ დავკარგოთ მონაცემები დოკუმენტებს, CRM-სა და ამოცანებს შორის, სტატიაში როგორ დავაკავშიროთ საიმედოდ დოკუმენტები, CRM და ამოცანები დავწერე. მიმართულებები: API-ინტეგრაციები მონაცემების გადაცემის გასაგები წესებით და CRM, რომელიც გუნდის მუშაობასთანაა დაკავშირებული. გვერდები თემაზე: საკუთარი API რამდენიმე აპლიკაციისთვის და ძაბრისა და კომუნიკაციების გეგმა GoHighLevel-ში. იმავე თემაზე: რა ეხება ინტეგრაციას GoHighLevel-ის ოქტომბრის ცვლილებებში და განახლების დაზიანების რადიუსი. ადრე ვწერდი, როგორ შევამოწმოთ API-ის კონტრაქტი ინტეგრაციის განახლებამდე, და Shopify-ის კატალოგის გამორთვაზე. თუ გაქვთ ინტეგრაცია, რომლის ვერსიაც არავის ახსოვს, მომიყევით, რომელი სერვისებია დაკავშირებული და ვინ უწევს მათ მხარდაჭერას. ამოცანის განხილვა.