Platform ekipleri · Yaşam döngüsü

Tasarlayın, yayınlayın, sürümleyin, emekliye ayırın — platformdan hiç çıkmadan.

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.

API lifecycle management — For platform teams use case overview from Apinizer.
For platform teams · API lifecycle management

Sorun

Çoğu ekibin bir API yaşam döngüsü yoktur. Bir wiki'si ve bir Slack kanalı vardır.

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.

  • 340

    API

    tek platformda yönetiliyor

  • 92

    legacy SOAP servisi

    planlanan takvimde emekliye ayrıldı

  • 3 gün

    inceleme döngüsü

    2 haftadan indi

Yetenekler

Apinizer'ın buradaki rolü

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.

Tek tıkla terfi

Bir tanımı runtime'a dokunmadan geliştirmeden teste, testten üretime taşıyın. Terfi bir toplantı değil, bir düğmedir.

Yan yana sürümleme

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.

Kesin bitişli kullanımdan kaldırma

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.

Kalıcılık katmanında denetim

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.

Programatik uygulama

İsim tabanlı referanslara ve idempotent uygulamalara sahip APIops manifest'leri. Mühendisler zaten kullandıkları Git üzerinden yayınlar.

Kullanım senaryoları

Canlı ortamda bu şöyle görünür…

  • Bankacılık

    İstanbul'daki birinci kuşak bir perakende bankası 340 API'yi tek çatıda topluyor

    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ı

  • Üretim

    Münih'teki otomotiv OEM'i, 14 fabrika ekibinde spesifikasyon öncelikli yaklaşımı standartlaştırıyor

    Fabrika entegrasyonları önce platforma OpenAPI taslağı olarak giriyor. Üretime terfi, kalite ve güvenlik onayı gerektiriyor — ikisi de gateway'e bağlı.

  • E-ticaret

    Amsterdam'daki pazar yeri, wiki'yle yürüyen süreci tek bir zaman çizelgesiyle değiştiriyor

    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

  • Kamu sektörü

    Stockholm bölgesel sağlık kurumu, spesifikasyonları üç ortam arasında terfi ettiriyor

    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.

  • Lojistik

    Varşova'daki 3PL, yüzlerce iş ortağı için sürümleri yan yana yayınlıyor

    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.

  • Sigorta

    Milano'daki sigortacı, 130 endpoint sonlandırmasını yayınlanmış bir takvimle uyguluyor

    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

  • Enerji

    Bakü'deki altyapı şirketi, her spesifikasyon değişikliğini bir talep numarasına bağlıyor

    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.

  • Telekom

    Atina'daki operatör, kod olarak API manifest'lerini GitOps ile yayınlıyor

    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

Dört aşama, tek zaman çizelgesi, tek doğruluk kaynağı.

Her aşama aynı platformda çalışır — dışa aktarımlar yok, paralel araçlar yok, geçmişi kaybettiren devirler yok.

  1. Adım 01

    Tasarla

    OpenAPI / SOAP / asenkron sözleşmeyi platformda taslaklayın. İnceleyiciler yerinde onaylar; doğruluk kaynağı spesifikasyondur.

  2. Adım 02

    Yayınla

    Tek tıkla — ya da tek APIops apply ile — staging'e terfi ettirin. Gateway yeni tanımı yeniden başlatma olmadan devralır.

  3. Adım 03

    Yönet

    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.

  4. Adım 04

    Emekliye ayır

    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.

API'leri wiki'de sürümlemeyi bırakın

Tek zaman çizelgesi. Taslaktan sonlandırmaya.

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.