Spesifikasyon öncelikli tasarım
OpenAPI, SOAP, gRPC ve asenkron desenler tek bir yerde taslaklanır, incelenir ve onaylanır — yayınlandıkları yerin ta kendisinde.
Platform ekipleri · Yaşam döngüsü
OpenAPI taslağından üretime geçişe kadar her API tek bir zaman çizelgesinde yaşar. Platform ekipleri mühendislere temiz bir hat, denetçilere temiz bir iz sunar.
Sorun
Spesifikasyonlar Confluence'a düşer. Deploy'lar birinin terminal geçmişinde yaşar. Sürümleme keyfe bağlıdır. Denetim ekibi çarşamba günü 14:32'de hız limitini kimin değiştirdiğini sorduğunda kimse yanıt veremez. Apinizer yaşam döngüsünü bir sisteme dönüştürür — mühendislerin tercih ettiği, denetçilerin güvendiği bir sisteme.
API
tek platformda yönetiliyor
legacy SOAP servisi
planlanan takvimde emekliye ayrıldı
inceleme döngüsü
2 haftadan indi
Yetenekler
OpenAPI, SOAP, gRPC ve asenkron desenler tek bir yerde taslaklanır, incelenir ve onaylanır — yayınlandıkları yerin ta kendisinde.
Bir tanımı runtime'a dokunmadan geliştirmeden teste, testten üretime taşıyın. Terfi bir toplantı değil, bir düğmedir.
Aynı endpoint'in iki sürümünü aynı anda çalıştırın. İş ortakları kendi hızlarında geçiş yapar; kimsenin pazartesisini bozmazsınız.
Bir endpoint'i kullanımdan kaldırılacak olarak işaretleyin, sonlandırma tarihini belirleyin, tüketicilere duyurun; süre dolduğunda gateway kapıyı kapatır.
Her değişiklik — kim, ne, ne zaman, hangi IP'den — değiştirilemez biçimde yazılır. Denetçi kanıtı adli bir proje değil, bir sorgudur.
İsim tabanlı referanslara ve idempotent uygulamalara sahip APIops manifest'leri. Mühendisler zaten kullandıkları Git üzerinden yayınlar.
Kullanım senaryoları
92 legacy SOAP endpoint'i, yayınlanmış bir takvimle emekliye ayrıldı. Spesifikasyon incelemeleri Confluence'tan gateway'e taşındı; kullanımdan kaldırma bildirimleri iş ortaklarına sonlandırmadan 90 gün önce ulaşıyor.
92 endpoint emekliye ayrıldı
Fabrika entegrasyonları önce platforma OpenAPI taslağı olarak giriyor. Üretime terfi, kalite ve güvenlik onayı gerektiriyor — ikisi de gateway'e bağlı.
Yayın öncesi incelemeler iki haftadan üç güne iniyor. Her sürüm; trafik sayıları ve tüketici dökümleriyle, yan yana sorgulanabiliyor.
İnceleme 2 hafta → 3 gün
Geliştirme → test → üretim tek komutla. Uyumluluk sorumlusu, mühendislerin gönderdiği manifest'in aynısını imzalıyor — paralel evrak işi yok.
v2024-q1 ve v2024-q3 eşzamanlı sunuluyor. İş ortakları kendi takvimlerinde geçiş yapıyor; gateway hâlâ v1'de olanları izliyor ve programatik olarak bilgilendiriyor.
Kullanımdan kaldırma header'ları tüketicilere 90 gün önceden ulaşıyor; geçiş gününde gateway, taşınma talimatlarıyla birlikte net bir 410 döndürüyor. Denetim, platform ekibine teşekkür etti.
130 endpoint, 0 sürpriz
Denetim izi; spesifikasyonları taleplere, talepleri deploy'lara bağlıyor. Düzenleyicinin üç aylık kanıt paketi, bir gecede üretilen tek bir dışa aktarım.
Mesai sonrası aramalar olmadan günlük deploy'lar. Aynı manifest'ler geliştirme, test ve üretimi besliyor — ortamlar tanımlarda değil, yalnızca değişkenlerde farklılaşıyor.
Nasıl çalışır
Her aşama aynı platformda çalışır — dışa aktarımlar yok, paralel araçlar yok, geçmişi kaybettiren devirler yok.
OpenAPI / SOAP / asenkron sözleşmeyi platformda taslaklayın. İnceleyiciler yerinde onaylar; doğruluk kaynağı spesifikasyondur.
Tek tıkla — ya da tek APIops apply ile — staging'e terfi ettirin. Gateway yeni tanımı yeniden başlatma olmadan devralır.
Politikalar ekleyin — kimlik doğrulama, hız limitleri, dönüşümler, sürümler — ve gerçek trafiği Analytics'te izleyin. Ne değiştirirseniz değiştirin; denetim kaydeder.
Kullanımdan kaldırılacak olarak işaretleyin, sonlandırma tarihi belirleyin, header'ları tüketicilere duyurun. Geçiş gününde gateway kapıyı kapatır — ve denetçinin elinde makbuz olur.
Önerilen ürünler
OpenAPI, SOAP ve asenkron desenler için spesifikasyon öncelikli tasarım — her API'nin başladığı yer.
Designer sayfasını açınYayınladığınız her sürümü, header'ı, hız limitini ve sonlandırma tarihini uygulayan runtime.
Gateway sayfasını açınHer sürümün ne yaptığına dair gerçek zamanlı kanıt — kim hâlâ v1'de, kim v3'e geçti.
Analytics sayfasını açınLLM ve agent endpoint'leri için aynı yaşam döngüsü. AI, API'nin yalnızca bir başka sürümüdür.
AI Gateway sayfasını açınKaynaklar
Platformun tasarım, terfi, sürümleme ve kullanımdan kaldırmayı uçtan uca nasıl ele aldığı.
Yaşam döngüsünün Kubernetes üzerindeki yeri — Manager, Worker ve denetim düzlemi.
İsim tabanlı referanslar, idempotent semantik ve arayüzle aynı denetim yüzüne sahip, Git'ten yönetilen uygulamalar.
Son yaşam döngüsü özellikleri — kullanımdan kaldırma header'ları, sürüm seçiciler, denetim dışa aktarımları.
Protokoller arasında tek tıkla proxy üretimi sunan OpenAPI öncelikli tasarım.
Apinizer'ın BDDK, KVKK, GDPR ve ISO 27001 kanıt gereksinimleriyle nasıl eşleştiği.
Daha fazlasını keşfedin
API'leri wiki'de sürümlemeyi bırakın
Seçtiğiniz bir Kubernetes kümesi üzerinde 30 dakikalık uygulamalı bir tur — tasarlayın, terfi ettirin, sürümleyin, emekliye ayırın.