Bir şehri sadece binalar oluşturmaz; yollar, köprüler, geçitler, tabelalar ve görünmez kurallar da oluşturur. Yazılım dünyasında da durum benzerdir. Uygulamalar, veritabanları, ödeme sistemleri, harita servisleri, yapay zekâ modelleri ve mobil istemciler tek başlarına birer bina gibidir. Güzel olabilirler, güçlü olabilirler, hatta kendi içinde kusursuz çalışabilirler. Fakat birbirleriyle konuşamıyorlarsa şehir değil, izole adacıklar üretirler. İşte API’ler, bu adacıkların arasına kurulan görünmez köprülerdir.
API, yani uygulama programlama arayüzü, çoğu zaman teknik bir ayrıntı gibi anlatılır: Bir sistemin başka bir sisteme sunduğu fonksiyonlar, uç noktalar, veri biçimleri ve kurallar bütünü. Bu tanım doğrudur ama eksiktir. Çünkü iyi tasarlanmış bir API yalnızca veri taşımaz; niyet taşır, sınır çizer, güven inşa eder ve karmaşayı yönetilebilir parçalara ayırır. Mimari tasarım olarak API, yazılımın nezaket protokolüdür. Kapıyı nasıl çalacağını, içeri girince nereye basacağını ve neyi isteyip neyi isteyemeyeceğini söyler.
