API sürümleri ve kapatma tarihleri: entegrasyon neden sonsuz değil ve takvime ne yazıyorum

Bu hafta birkaç sağlayıcı birden hatırlattı: başkasının API'siyle yapılan entegrasyon, sağlayıcı eski sürümü tuttuğu sürece yaşar. Weaviate GraphQL'in kapatılma tarihini açıkladı, Meta HighLevel aracılığıyla WhatsApp pazarlama mesajlarının Cloud API üzerinden Ekim 2027'de biteceğini duyurdu, Twilio webhook ayarları için bir API çıkardı, Shopify Hydrogen'ı kütüphaneye dönüştürdü. İşletme sahibi için bunun önemi şu: siteden gelen başvurular ve müşterilere giden mesajlar bu tür bağlantılardan geçiyor ve sağlayıcı bir sürümü kapattığında CRM'nize uyarı olmadan gelmeyi kesiyorlar.

Ne çıktı

n8n 22 Ekim'de sağlayıcıların API'yi nasıl sürümlendirdiğini ayrıştırdı: URL yolunda /v1/products gibi, HTTP başlığında, çıkış tarihiyle ya da istek parametresiyle. Entegrasyon için önemli olan, sürümün nerede belirtildiğini ve sonunun nasıl fark edileceğini bilmek. deprecation başlığı sürümün kullanımdan kaldırıldığını söylüyor, sunset başlığı kesin tarih veriyor, o tarihten sonra sağlayıcı 410 Gone yanıtı verebiliyor.

Weaviate 26 Ekim'de ilk sorgu API'si GraphQL'in kullanımdan kaldırıldığını duyurdu. O gün hiçbir şey bozulmuyor. Son 30 günde GraphQL kullanmamış Weaviate Cloud kümeleri 1 Aralık 2026'da, geri kalanlar 1 Mayıs 2027'de kapatılacak. Yeni kümeler zaten onsuz oluşturuluyor. Uygulama güncel Python, TypeScript, Java ya da C# istemcileriyle çalışıyorsa büyük olasılıkla etkilenmiyor: onlar gRPC üzerinden çalışıyor. Dört adımlık geçiş planı: kodda ve proxy'de /v1/graphql çağrılarını bulmak, bir yedek seçmek, sorguları aktarmak, uygulamayı GraphQL kapalıyken kontrol etmek.

Twilio 15 Ekim'de Webhook Configuration API'yi genel kullanıma açtı: onunla Twilio'nun giden webhook'ları nasıl imzalayıp teslim edeceğini, her URL için ayrı ayrı, Webhook Settings ve Webhook Rules adlı iki kaynakla belirliyorsunuz. Changelog kaydında yalnızca bu var, ayrıntılara bakmadım.

HighLevel 19 Ekim'de Meta'nın kararını iletti: 13 Ekim 2027'den itibaren WhatsApp pazarlama mesajları Cloud API üzerinden teslim edilmeyecek, HighLevel'da MM Lite adıyla geçen Marketing Messages API üzerinden gönderilmeleri gerekecek. Servis ve yardımcı mesajlar Cloud API'de kalıyor. Aktivasyon alt hesap başına birkaç dakika sürüyor, şablonları ve numaraları HighLevel olduğu gibi taşıyor. HighLevel, Meta'nın 12 milyondan fazla mesajlık A/B testine atıf yapıyor: yüksek etkileşimli mesajlarda teslimatta %9'a kadar artış. Bu sayıyı doğrulayamıyorum, Meta'nın metninden HighLevel'ın aktarımıyla geliyor.

Shopify 14 Ekim'de Hydrogen 2026-10'u çıkardı. Daha önce React Router üzerine bir framework'tü ve sepetini ya da analitiğini almak için vitrini baştan sona onunla kurmak gerekiyordu. Artık her JavaScript framework'ü için bir kütüphane: sepet, alıcının para birimiyle fiyatlar, Shop Pay ve alıcı girişi. Eski vitrinler çalışmaya devam ediyor. Preview'ın başladığı hazirandan bu yana yedi sürüm çıktı.

İşletmeye bunun ne faydası var

Bir hizmet şirketi düşünelim. Siteden gelen başvurular CRM'ye gidiyor, oradan müşteriye onay WhatsApp'ı gidiyor, telefon sisteminde ise arama lead oluşturuyor. Üç sağlayıcı, üç API sürümü. Sürümün sona ereceğine dair mektup, entegrasyonu iki yıl önce yapmış ve çoktan başka işe geçmiş yüklenicinin postasına gidiyor. Kapatma tarihinde başvurular gelmeyi kesiyor ve bunu ilk fark eden, salısı lead'siz geçen satışçı oluyor.

Sonuç: her entegrasyonun bir sahibi, bir sürümü ve kesin çalıştığı bir tarihi var. Bu üçünden biri bile yoksa sonunun tarihi bilinmiyor ve siz onu olay olunca öğreniyorsunuz.

Bende nasıl kurulu

ABD'deki PDR şirketinde 2021'den beri sunucu, telefon sistemi, parser'lar ve CRM bağlantısını yürütüyorum. 2022'de satışçıların AppSheet üzerindeki uygulamasının GoHighLevel entegrasyonunu yazdım, 2023 boyunca da onu geliştirdim; bu arada şirket Google E-Tablolar'dan MariaDB'ye geçiyor ve yeni servisleri birer birer bağlıyordu. İç API'yi bu yıllarda üçüncü sürüme getirdim, yani sürüm değişimini iki taraftan da biliyorum: başkasının API'sinin tüketicisi ve kendi API'min yazarı olarak. Oradaki yığında Twilio ve GoHighLevel var, dolayısıyla bu incelemedeki iki changelog'u da uygulayacak yerim var ve kapatma takvimi bende bakımın parçası.

Güney Afrika'daki araç kiralama şirketinde Ekim 2024'ten Şubat 2025'e kadar FlutterFlow üzerindeki uygulama ile Firebase backend'i ve AmoCRM arasında alan senkronizasyonunu kurdum; bu bağlantı da başkasının API sürümü üzerinde yaşıyor.

Ben ne yapardım

Entegrasyon listesi çıkarmak: sağlayıcı, sürüm, nerede belirtildiği, sağlayıcıdan gelen mektupları kimin aldığı. Bu bir saat alıyor ve ilk kapatmada kendini ödüyor.

Sağlayıcı yanıtlarındaki deprecation ve sunset başlıklarını loglamak ve ortaya çıktıklarında bildirim vermek. Bu, sunucuda tek bir middleware.

410'u sıradan hatalardan ayrı ele almak. Burada yeniden denemeler yalnızca logu kirletiyor.

Yeni sürümü geçişten önce ayrı bir ortamda kontrol etmek. Weaviate, test kümesinde GraphQL'i kapatıp neyin bozulduğuna bakmayı öneriyor.

Tarihleri takvime şimdiden yazmak: Weaviate'te 1 Aralık 2026 ve 1 Mayıs 2027, Meta'da 13 Ekim 2027. HighLevel'daki WhatsApp için MM Lite'ı en yoğun alt hesapta açmak ve bir yıl pay varken teslimatı kontrol etmek.

İlgili içerikler

Belgeler, CRM ve görevler arasında veri kaybetmemeyi Belgeler, CRM ve görevler nasıl güvenilir biçimde bağlanır yazısında anlattım. Alanlar: veri aktarım kuralları net API entegrasyonları ve ekibin işine bağlı CRM. Konuyla ilgili sayfalar: birkaç uygulama için kendi API'si ve GoHighLevel'da huni ve iletişim planı. Diğer incelemelerden: GoHighLevel'ın ekim değişikliklerinde entegrasyonu ne ilgilendiriyor ve güncellemenin etki alanı. Daha önce entegrasyonu güncellemeden önce API sözleşmesi nasıl kontrol edilir ve Shopify kataloğunun kapatılması hakkında yazmıştım. Sürümünü kimsenin hatırlamadığı bir entegrasyonunuz varsa, hangi servislerin bağlı olduğunu ve kimin baktığını anlatın. Görevi konuşalım.