- API yayılımı, özellikle hibrit, mikro hizmet ve DevOps odaklı ortamlarda, kontrolsüz büyüme ve zayıf yönetimden kaynaklanır.
- Gölge, başıboş, sahipsiz, zombi ve eski API'ler, kuruluş genelinde güvenlik, uyumluluk ve operasyonel riskleri artırır.
- Merkezi keşif, güncel bir API kataloğu ve risk odaklı güvenlik duruşu yönetimi, görünürlüğü ve kontrolü yeniden kazanmak için şarttır.
- Hafif yönetim yapısı, özellik odaklı tasarım ve güçlü bir geliştirici deneyimi kültürü, zaman içinde plansız ve kontrolsüz büyümenin yeniden ortaya çıkmasını önlemeye yardımcı olur.
API'ler modern dijital ekonomide görünmez bir şekilde dönüştürülür, başka bir geleneksel kurguya sahip olan uygulamalar, hizmetler, veriler ve biçimlerdeki aygıtları bağlayın. Yeni uygulamalar, mikro hizmetler ve daha fazla çeşitli API'ler içeren harici bir kanıtlayıcıyla entegrasyon. Sonuç, kontrol altına alınamadığı takdirde "API yayılımı" ifadesinin daha da yaygınlaşmasından kaynaklanan patlayıcı bir sonuçtur.
API'lerin yayılması, API'ler kadar tek başına değildir; daha zayıf, daha az dağılmış ve daha kötü göçebeler. Bu, API'lerin organizasyona bağlı, canlı, açıklayıcı, güvenli ve gerekli güvenlikleri sağlamak için sertifikalandırılmasını sağlayan bir noktadır. Böylece güvenlik, normatiflik, verimlilik ve geç kalana kadar çözülebilecek maliyet sorunlarını ortadan kaldırmış olursunuz.
API yayılması tam olarak nedir?
API yayılımı, bir kuruluşta API'lerin kontrolsüz çoğalmasını ve merkezileştirilmesini açıklamaktadır. Basitçe yüksek bir arayüze sahip olmanıza gerek yok, çünkü API'lerin koordineli bir şekilde çoğaltıldığı bir ekosistem ekosistemi, yeni topluluklar ve yaşam döngüsünün merkezileştirilmiş bir vizyonu var.
Bu senaryoda, yeni uç noktalar sürekli olarak ortaya çıkıyor — farklı ekipmanlar tarafından, farklı platformlarda ve farklı teknolojilerle oluşturulmuş bir menü — bir kayıt defterinde veya bir ürün politikası, belge, güvenlik veya kullanımdan kaldırılmadan. Verilerin size yanıt vermesini sağlayacak bir API hizmeti için referanslar bulunur.
API yayılımıyla ilgili organizasyonlar, temel yanıtların verilmesinde bazı seri zorluklarla karşılaşıyor Arayüzlerin ekolojik sistemi hakkında bilgi:
- ¿Cuántas API'leri işletmenizde gerçekten mevcut mu?
- Entornos, nubes veya veri merkezleri tükendiğinde mi?
- Hangi API'yi, desteklenen hizmetleri ve süreç verilerini biliyor musunuz?
- Dışarıdan bilgi alıyor ve internetten yararlanıyor musunuz, ve içeriden de bilgi alıyor musunuz?
- Her gün hizmet vermek için gereken donanımlar ve yaşam döngünüzde politikalar nasıl gelişiyor?
- API'ler güvenlik politikaları veya uyumluluk tanımlarını zorunlu kılıyor mu?
- Yükselişler uç nokta için kabul edilebilir mi ve zamanında izleniyor mu?
Organizasyonunuz bu tür soru türlerine güvenerek yarışmaya katılmadığınız takdirde, güvenlik kazaları olasılığı, işlem hataları ve maliyet düşürme maliyetleri birbirinden farklıdır.

API karmaşasının hızla artmasının altında yatan nedenler:
API'lerin yayılmasının genişletilmesi tesadüfi değildir; Bu, çeşitli teknoloji ve organizasyon eğilimlerinin doğrudan sonucudur aynı anda harekete geçiyoruz. Bu dürtüleri harekete geçirerek, sorunla başa çıkabilirsiniz.
Bir yandan da, birçok organizasyonda çoklu API kullanılıyor. Gartner, işletmelerin %80'inden fazlasının dahili API kullandığını ve %70'inden fazlasının da üçüncü taraf API'lerini kullandığını tahmin ediyor. İnternet dinamik trafiği gibi farklı API trafik kanıtları hakkında bilgi verir ve milyonlarca yıllık API'ler de dahil olmak üzere millerce API dahil olmak üzere, halka açık ve özel kullanımda yaklaşık 200 milyon API'ye ilişkin tahminler sunar yaklaşık on yılda aktif hale geliyor.
Bu belge, mikro hizmet mimarileri ve uyumlu işletme modeli tarafından onaylanmıştır.. Dahili hizmet biriktiren büyük kurumsal gruplar: 10.000'den fazla çalışana sahip şirketlerde, tanımlanmış 250'den fazla dahili API'nin bulunması nadirdir… ve bundan çok daha fazlası. Mikro hizmetler, mikro hizmetlerin yanı sıra "hacia arriba" (ön uçlar, uygulama filmleri, iş ortakları) gibi çeşitli arayüzler sunar.
Gerçek karma ve çoklu bulut, başka bir komple kapasiteye sahip. Merhaba, şirketlerin %80'i üç veya daha fazla mimariyle çalışıyor: çok sayıda kamu, veri merkezleri ve daha fazlası, uç ve IoT. API'ler, görünürlüğü ve kontrolü büyük ölçüde karmaşık hale getirecek şekilde birçok farklı kopya ve farklı kopyalarla yeniden düzenlenir.
DevOps bilgileri ve genişlemeyi hızlandırmak için geliştirme hızını artırmaya yönelik devam eden girişler. Her gün veya her gün yeni sürümlerin çıkarılması, ekipmanların çok çeşitli zamanlarda yeni API'ler veya mevcut çeşitli varyasyonları yayınlayabileceği anlamına gelir. İlk olarak işe yarar bir işleve sahip olduğunuzda, başlangıç uç noktalarını, geçici sürümleri veya serbest bırakılan klonları hızlı bir şekilde oluşturursunuz.
Son olarak, toplulukların yanlış durumu ve açık bir devlet modeli, sorunu canlı tutan en iyi örnektir. OpenAPI veya sektör spesifik normları (örneğin, finans sektörü için FDX) gibi mevcut kılavuzlar ve spesifikasyonlar, tek bir referansta birden fazla stil, konvansiyon ve versiyonla bir araya getirilen birçok organizasyonda pratikte mevcuttur. API'lerin donanımı ve yönetimi için tanımlanmış bir "asfalt yol" olduğundan, bazı ekipmanlar kendi iş biçimini icat etmeyi başardı.
Şehirleşmeyi körükleyen API türleri (ve neden önemli oldukları)
Yayılmayı yönetmek için, bir kuruluşta toplanan API'lerin farklı "saboraları" arasında ayrım yapılması önemlidir.. Hiçbiri serinin aynı seviyesini temsil etmiyor ve daha fazla arabanın çoğu, TI ve güvenlik merkezlerinin ekipmanlarında görülmüyor.
API'leri büyük gruplara ayırmak için kullanabileceğiniz yöntemler:
- APIs conocidas: Belgeler, Onaylar ve Aktif Kullanımlar; bir kataloga, sürümlere ve monitörlere kaydolun.
- API'ler desconocidas: resmi sürecin işleyişi, belgelemenin açık ve net olmaması nedeniyle, ve bu da sürece en fazla katkıda bulunanlardan biri.
Açık API'lerde, çeşitli alt kategorilerdeki problemler ortaya çıkıyor:
Gölge API'ler: Müşteriler veya departmanlar tarafından, sözleşmenin gerektirdiği gerçekleri çözümlemek için kullanılan arayüzler, ancak resmi bir işlem, revizyon veya başka bir işlem tarafından geçilmemiştir. Bir uygulamanın dahili uç noktaları, "geçiş için" lanzados mikro hizmetleri veya TI'ye katkı sağlayan SaaS ile entegrasyonlar olabilir. İşlev… Hacerden çıkana veya kullanımı kolaylaştırana kadar.
Sahte API'ler: Doğrudan API'ler yetkilendirilmez, bireyler veya ekipmanlar tarafından tanıtılır ve kimlik doğrulama politikası, yetkilendirme ve kayıt için bir menü sunulur. Var olan güvenlik araçlarını izlenmiyor ve aynı zamanda atılımlar için kolay hedefler var.
Yetim API'ler: Fueron, şu anda yasal arayüzlere sahip, ancak yeniden yapılandırılan ekipman nedeniyle "huérfanas", sorumlular harekete geçirildi veya ürün öncelikleri değiştirildi. Etkinleştirmeler, ancak gerekli olup olmadığı veya güvenlik açıklarının güvenlik açıkları nedeniyle göz ardı edilmemesi gerektiği anlamına gelir.
Zombi API'leri: API'ler, teorik olarak, artık kullanılmaması nedeniyle kullanımdan kaldırıldı ve geçerliliğini yitirdi, ancak bugün dilekçeleri kabul ediyor ve yanıtlar alıyoruz. Yeni sürüme geçiş yapmayan istemciler için hassas veriler ve hareket ve değerlendirme işlemleri içeren bir menü oluşturuldu. Ekipmanlarınızda aktif radar bulunmadığından, bakım ve güvenlik önlemlerini alabilirsiniz.
Eski API'ler: Arayüzler, zamana uygun olarak görülebilecek şekilde eski teknolojiler veya güvenlik standartları ile yapılandırılmıştır. Her ne kadar atanmamış olsa da, müzakere süreçlerinin merkezini takip ediyoruz. Varoluşun tümü, ahşap yüzeyle birleştiğinde, yeni bir yapısal yapıya dönüştürülür.
Partner y üçüncü taraf API'leri: Organizasyonun doğrudan kontrolü altında olmayan sosyal çevreler ve dış çevrelerle entegrasyonlar. Yeterince buluş yapılmadığı ve denetlenmediği takdirde, bu bağlantı noktaları önemli noktalara dönüştürülür: açıklanamayacağından, korunduğundan ve düzenleyici açıdan etkili olmadığından.
Kesin rakamlar: Veriler API yayılımı hakkında ne söylüyor?
Güvenlik ve ticari bilgilerle ilgili olarak kamuya açıklanan veriler, API'lerin yayılmasının marjinal bir sorun olmadığını açıkça ortaya koyuyor, tek bir masivo ve tüm sektörlerdeki uygulamalar için çapraz.
Çeşitli kuruluşlarda, organizasyonların yaptığı araştırmalar, yayılmanın API'ler açısından en büyük güvenlik açığı olduğunu düşünüyor.. Bunlardan biri, arayüz ekosistemini yönetmek için bir engel olarak kontrolsüz çoğalma oranı gösteren şirketlerin yüzde 48'inde bulunuyor.
Görünürlük sorunu kafamı meşgul ediyor. Bazı raporlara göre kuruluşların yaklaşık %39'u, API'lerinin tam bir envanterini kullandıklarını kabul ediyor. Diğer analizler, medya şirketlerinin ekrandaki API aktivitelerinde %10 ve %20'den fazla olduğunu ve bu da atak yüzeyinin önemli bir kısmının icat edilmediğini gösteriyor.
Görünürlük kaybı kaçınılmaz olarak güvenli bir şekilde gerçekleşiyor. Küresel düzeyde güvenli API'ler, organizasyonların en son yıllarda API'lerle tek bir ilişki kurması nedeniyle daha fazla güvenlidir ve bu, bazı önemli fraksiyonların da önemli bir kısmıdır. Buna paralel olarak, belirli aralıklarla üç haneli tuzlarla, özellikle API'lere yönelik kötü amaçlı trafikte dikkate değer bir artış gözlemliyoruz.
Ekonomik maliyet oldukça önemlidir. Diğer vektörler üzerinde bir API kodunun somut etkisinin anlaşılması zor olduğundan, genel tahminler, çeşitli milyonlarca dolarlık bir veri kaynağının maliyetine ilişkindir. Kökeni terkedilmiş bir API olduğunda, kötü koruma veya gizlilik söz konusu olduğunda, veri itibarı birçok düzenleyici kurumla birleşir ve müşterilerin ve iş ortaklarının güveni sağlanır.
Son olarak, teknoloji kullanımıyla ilgili bilgiler rahatlatıcı bir veri ortaya çıkarıyor: Bazı sondalarda, kuruluşların %78'i API'ler hakkında tam olarak bilgi sahibi değil. Korumak, optimize etmek ve kiralanabilir hale getirmek zordur, ancak hassas bir şekilde kontrol edilemez.
API karmaşasının bu kadar büyük bir sorun olmasının nedenleri
API'lerin yayılması, güvenlik ekipmanı açısından tek başına karmaşık değil; bu etkiler işlem günlüğünde, yenilik kapasitesinde ve en son örnekte, sonuçların ışığında not edilir.
Görünüm operasyonunun bir parçası olarak, kötü koordinasyonlu API'lerin fazlalığı, her alanda sürtünmeye neden olur. Geliştiriciler, doğru sürüme bağlı olarak hizmetlerin mevcut olduğu süre boyunca veri erişimi sağlar ve erişim sağlamak için uç noktanın kullanılması gerekir. Açık bir katalogda, farklı ekipmanların, diğer işlerin üstesinden gelmek için özdeş işlevler oluşturması alışılagelmiş bir durumdur.
Bu kopyalar, yönetilecek daha fazla kod, izlenecek daha fazla hizmet ve çalıştırılacak daha fazla bağımlılığa dönüştürülüyor. Parçalar daha bağımsız olduğu için, bir müşteri eleştirisiyle iletişimin gerçekleştirilmesi daha kolay ve mimari düzeydeki geniş değişiklikleri koordine etmek daha da zor.
Geliştirici deneyimi planında, çok kötü bir entegre etme konusunda tutarsız bir API ödemesi var. Farklı türdeki API'leri (REST, SOAP, gRPC, sanal sunucular, web kancaları, akışlar vb.) birleştirmek, başka bir sürekli zihinsel modelin tuzağını sağlamak için bir kılavuz gerektirir. Ayrıca, API'lerin bir parçası belgelenmişse ve geri kalanı "kabileyle yakın ilişkilere" bağlıysa, yeni geliştiricilerin katılımı zor ve hayal kırıklığı yaratıyor.
Güvenlik muhtemelen yayılmanın daha da kötüleşmesine neden oluyor. Keşfedilmemiş veya hatalı icat edilmiş uç nokta, potansiyel bir saldırı vektörüdür. Gölge ve hileli API'ler, sağlam bir kimlik doğrulama menüsüne, yetkilendirme finans kontrollerine ve yeterli görev sınırlarına sahiptir. Eski, artık kullanılmayan ve zombi API'leri, yıllar içinde bazı güvenlik açıklarının bir araya gelebileceği güvenlik düzeltmeleri içeriyor.
GDPR, HIPAA veya PCI DSS gibi düzenleyici düzenleyiciler, hassas verilerin dolaşımda tutulması ve uygulanmasının kontrol edilmesi konusunda hassastır.. Yaygın bir avantajla, tüm kameraların korunduğunu, verileri en aza indirme ilkelerine uyduğunu veya tam formda kaydı tamamladığını göstermek neredeyse imkansızdır.
Son olarak, bu yayılma, API'lerin yaşam döngüsü yönetimini oldukça karmaşık hale getiriyor. Her şeyi doğrulamak için "geçici olarak" kullanımdan kaldırılan sürümler, izleme gerektirmeyen eski uç noktaları kullanan istemciler, duyurulduğunda tanıtılan uyumluluk değişiklikleri... Zombilerin uç noktaları, dönüşümler ve üretimde bozulabilen bazı sorunlar için çok fazla yer var.
Gerçek organizasyonlarda plansız yayılma nasıl gerçekleşir?
Uygulamada, API'lerin yaygınlığı çok iyi görünüyor; birikmiş ve pocoOrganizasyonun yeniden düzenlenmesi ve yeni teknolojilerin benimsenmesi sayesinde.
El ciclo suele empezar de manera çok masum: yeni bir dijital ürün veya hizmetle donatılır ve diğer uygulamaların mantık veya verileri yeniden kullanabilmesi için dahili API'ler sunar. Başkalarının da bu fikri kopyalamasını sağladığı gibi, bazı özellikler, çerçeveler ve düzenlemelerle de işlev görür.
Bu süre zarfında, şirket mikro hizmetleri benimser, harici SaaS entegrasyonlarını çoğaltır ve sık sık ağ dinamiğine girer.. Sprint, yeni API'ler veya mevcut çeşitli API'ler sunabilir. Belgeler "zaman yok" olarak kabul edilir veya ikinci bir alan olarak algılanır.
Dahili yeniden düzenleme, kişisel kayıtlar ve diğer şirket talepleri daha fazla tamamlayıcı kapasiteye sahip. Eski API'ler, yakın zamanda test edilemeyen veya anında doğrudan sorgulanabilen birçok yeni ekipmana sahiptir. Buradaki sistemler, daha modern platformlarla entegrasyon sağlamak için yeni arayüzlere sahip olmakla birlikte, bu seriye geçiş yoluyla "özel" olarak yönetilmektedir.
Buna paralel olarak, yenilikçilik ve yeni işlevsellik prestiji, API'lerin hızlı ve geleneksel olarak oluşturulmasını teşvik ediyor. Bir menü, bir satış zamanı veya bir canlı yayın eleştirisi almak için gerekli olan bilgilerle birlikte kurumsal görünümler sağlayan revizyon süreçlerini veya mevcut sürümleri içerir.
Bir güvenlik açıklığı, görünürlük ve temizleme süresine sahip bir stratejimiz varTüm bu faktörler birleştirilir ve kırmızı bir uç nokta donanımı, sürümler, stiller ve yaygın sorumluluklar oluşturulur: yayılma için mükemmel bir ortam.
Organizasyonunuzun API yayılımı sorunu olup olmadığını tespit etmek
Yayılma sınırını işaret edecek tek bir ölçüm yok, uyarı işaretleri var bu, durumun manos'ta boşaldığını gösteriyor.
Yanıtlayıcının bir önceki güne göre dürüst bir yanıt verme şekli sobre tu ecosistema actual:
- Merkezileştirilmiş bir buluş var mı ve tüm etkin API'ler hayata geçiriliyor mu?
- Belgeleri açık bir şekilde kullanarak API'yi nasıl kullanıyorsunuz, erişilebilir ve bakımlı mı?
- Yeni API'leri oluşturmak, gözden geçirmek, onaylamak ve kaldırmak için bir prosedürünüz var mı?
- Geliştiriciler, yeni bir sürüm oluşturmadan önce API'lerin yeniden kullanımını kolaylaştırabilir mi?
- Uç noktaların özellikle hassas verilerle korunup korunmadığını biliyor musunuz?
- Kullanımdan kaldırılan öğeler ve eski sürümlerden kaldırılanlar ile tutarlı bir şekilde iletişim kuruyor musunuz?
Çeşitli sorularda yanıt "hayır" veya "güvenlik yok" iseMuhtemelen, bugün olumsuz etkilerinin hiçbirini göstermemesine rağmen, yüksek düzeyde bir yayılma düzeyine sahip olmuşsunuzdur.
Diğer bir gün ve gündeki belirtiler ortaya çıktı: Kullanılan API'ler, duyurulmayan değişikliklerle sağlanan entegrasyonlar, büyük stil farklılıkları ve alınan ve eski hizmetler arasındaki güvenlik ve geç tespit edilen kopyaların kullanılmasına izin vermeyen ekipmanlar.
API yayılımını azaltmak ve kontrol altına almak için temel stratejiler
Bu, API'lerin yayılmasının bu ortamda çılgınca geri dönebileceğine dair bir uyarıdır.. Benzersiz bir büyülü büyü yok, ancak birleştirilmiş pratikler ve yetenekler bir araya gelerek kontrolü geri kazanmaya izin veriyor.
Görünürlük için yapılması gerekenler. API'lerin mevcut olduğu ve uyumlu olduğu bir görüntü olduğundan, bu uygulamanın amacı kısmidir. Bu, en etkili bilgilerin, çalıştırma sırasındaki trafik gibi kodu gözlemleyen otomatik açıklama mekanizmalarıyla düzenlenmesini sağlar.
API açıklamasındaki modern çözümler birden fazla kaynakta kullanılabilir: veri havuzlarının analizi, ağ geçitleri ve API kodlarının entegrasyonu, kırmızı trafik denetimi (geleneksel ağ geçitlerini tuzlayan giriş noktaları dahil) ve eBPF gibi daha fazla avantaj tekniklerini, bu özelliklerde nelerin meydana geldiğini denetlemek için içerir iş yükleri.
Bu bilgilerin birleştirilmesiyle merkezileştirilmiş bir katalog oluşturuluyor uç noktaların tek başına numaralandırılmaması nedeniyle, meta veriler eleştirmenleri tarafından eleştirilmekte: sahibi olarak, veri yönetiminin türü olarak, uluslararası olarak, halka açık veya üçüncül olarak, güvenlik politikalarının uygulanması durumunda, verinin atanması ve aşamasına geçilmesi durumunda bu hayat döngüsü.
Bu temel, çok etkili olsa da, büyük liglerin marcos'unu boşaltabilir. Yeniliklere öncülük eden bir bürokratik destek yok, çünkü sürtünmeyle elde edilebilecek minimum sürüm, isimlendirme, doğrulama, belgeleme ve sürümle ilgili bir "kaplanmış kart" donanımına sahibiz.
Otomatikleştirme bir kağıt eleştirisi getirdi. CI/CD işlem hatlarında stil doğrulamaları, güvenlik ve doğrudan sağlama (özellik satırları, otomatik doğrulama ve yetkilendirme işlemleri, hassas verilerin açığa çıkarılması vb.) dahil edilmesi, birçok kararın uygulanmasına izin verir. sürekli olarak, kılavuzların revizyonlarına bağlı olarak değişir.
Son olarak, kullanımdan kaldırma ve sistemden kaldırma işlemlerinin temel tanımı ve uygulaması. Marjinal kullanılan API'leri, eski sürümleri veya yedek hizmetleri tanımlayın, tüketicileri önceden bilgilendirin, her şeyi izleyin ve anlık olarak kontrol edilen uç noktaları, yayılmanın süresiz olarak oluşturulmaması için kontrol edin.
Güvenlik durumu, veri ifşası ve API yayılımı
Pek çok organizasyonun doğuştan gelen bir yönü, her API'nin doğasında bulunan yüktür., tüm uç nokta numaralandırmasından daha fazlası. Hiçbir arayüz aynı eleştiriye tabi değil: diğer kimlik bilgileri, kişisel bilgiler veya yüksek değerli işlemlerle ilgili olarak kamuya açık veriler açıklanıyor.
Güvenlik API platformları, güvenlik duruşuna ilişkin derinlemesine bir analizle açıklamaları birleştirerek daha fazla avantaj sağlar. Trafiğin sürekli gözlemlenmesi ve güvenlik açığı katalogları ve saldırı destekçileri ile yapılan korelasyonlar sayesinde, API'lerin kötüye kullanıma daha duyarlı olduğunu tespit etme kapasitesi artar veya koruma açısından mantıklı veriler elde edilir.
Özel bir nokta, hassas verilerin ifşa edilmesidir. Kişisel bilgileri kabul eden veya edinilen uç noktalar, daha kapsamlı kimlik doğrulaması için finans veya sağlık hizmetleri, yeterli miktarda bilgi aktarımı veya aşırı ayrıntılı yanıtlar, sistemdeki her şeyi zayıflatan bir çalışma ortamına dönüştürülebilir.
Verileri önceliklendirmek için bu zekayı katalog merkezi iznine entegre edin: "her şeyi güvenlik altına alma" amacı doğrultusunda, ekipmanlar daha etkili bir şekilde ödün vererek, kimlik doğrulama güvenliklerini ihlal ederek, bağlam tabanlı yetkilendirmeyi yeniden yapılandırarak ve görevlerin veya anormalliklerin tespit edilmesiyle ilgili uygulama kontrollerini uygulayarak öncelikle API'lere odaklanabilir.
Aynı zamanda, hassas veri akışının eksiksiz bir vizyonu, en önemli düzenleyici gerekliliklerin önünü açıyor. Daha fazla veriyi tam olarak takip ederek, politikanın genel ve basit bir şekilde yapılmasını sağlayarak, denetim hazırlığı ve rapor hazırlığı gibi etkili kontrol sistemini kolaylaştırın.
Geliştirici deneyimi, kültürü ve uzun vadeli API sağlığı
Tüm kutsal kitaplara ek olarak, yayılmanın bir kez veya başka bir şekilde yeniden üretilememesinde kültürel faktör belirleyicidir.. API'lerin kullanıldığı organizasyonlar, teknik ayrıntılar kadar basit değil, ürün olarak iş görüyor.
Kamuya açık bir nesneye, kullanılabilirliğine, desteğine ve geniş kapsamlı bir evrime yönelik bir API ürünü tasarlayın. Örnekler, kullanım koşulları ve açıklamalarla birlikte çalışma belgelerini tersine çevirin, SDK'ları düzenleyin veya anında etkinleştirilen istemcileri şeffaf olarak paylaşın ve değişiklikleri ve kullanımdan kaldırılanları şeffaf olarak paylaşın.
Bu zihinsel bileşenin bir bileşeni, dahili bir geliştirici portalının varlığıdır.API'leri tanımlamak için tek bir giriş noktası olarak hareket eder, kullanıcı olarak girer ve erişim talebinde bulunur. Bu portalda yalnız bir katalog yok: kullanım etkileşimleri, kullanım ölçütleri, iletişim bilgileri ve en önemli uygulama kılavuzlarını içerir.
Diseño standartlaştırma ve uluslararası stil kılavuzları seyahatleri, "bozulmuş" yayılmanın azaltılmasına büyük ölçüde katkıda bulunmuştur.. Yeni API'nin tanıdık ve entegre edilmesi daha kolay olacak şekilde yineleme adları, hata kullanıcıları, sayfalar, filtreler ve kimlik doğrulama modelleriyle birlikte geleneksel ekipmanlarla hizalayın.
Özellikle OpenAPI gibi makineler tarafından okunabilen özellikler, bu özel sütunlar olarak mevcuttur. Belgeler, modeller, testler ve birçok durumda SDK'ların tek bir zıt kaynağın bir parçası olarak yönlendirilmesine olanak tanıyan özel bir kılavuz kılavuzu benimseyin, uygulama ve belgeleme sırasındaki farklılıkları azaltın.
Son olarak, kumaş yolculukları ve sıcaklık düzenlemelerinin otomatikleştirilmesi — üretim kodundan önce API tanımlarını değerlendirmek — mimaride tutarlı biçim normlarının uygulanmasına ve tekrarlanan konularla insani revizyonların yapılmasına izin verir.
Buna ek olarak, görünürlük teknolojisinin bir kombinasyonu, veri denetimi ve API'lerin sağladığı ürün kültürü, bir arayüz tablosunun sağlam ve ölçeklenebilir bir platformda dönüştürülmesine olanak tanır.. Yayılma, büyü sanatından vazgeçmiyor, ancak ele alınabilir bir soruna dönüştürmek için bir susturma alanı sunuyor, mimariyi açıklamak, rasyonelleştirmek ve güvence altına almak için açık planlar sunuyor.