API nedir?

API mimarisi genellikle istemci ve sunucu bakımından açıklanır. İsteği gönderen uygulamaya istemci, yanıtı gönderen uygulamaya ise sunucu adı verilir. Yani hava durumu örneğinde, müdürlüğün hava durumu veritabanı bir sunucu iken, mobil uygulama ise bir istemcidir. 

Ne zaman ve nasıl oluşturulduklarına dayalı olarak API'ler dört farklı şekilde çalışabilir.

Bu API'ler, Basit Nesne Erişimi Protokolünü kullanır. İstemci ve sunucu, XML aracılığıyla mesaj alışverişi yapar. Bu, diğerlerine kıyasla pek esnek olmayan ve artık popülerliğini yitiren bir API'dir.

Bu API'lere, Uzak Prosedür Çağrıları adı verilir. İstemci, önce sunucu üzerinde bir işlevi (yani prosedür) tamamlar ve ardından sunucu da çıktıyı istemciye gönderir.

WebSocket API'leri, verileri aktarmak için JSON nesneleri kullanan başka bir modern web API'si gelişimidir. Bir WebSocket API'si, istemci uygulamaları ile sunucu arasında iki yönlü iletişimi destekler. Sunucunun bağlı istemcilere geri arama mesajları gönderebilmesi nedeniyle REST API'lerinden daha verimlidir.

Bunlar günümüzde web'de bulunan en popüler ve esnek API'lerdir. İstemci, sunucuya isteklerini veri olarak gönderir. Sunucu bu istemci girdisini kullanarak dahili işlevleri başlatır ve çıktı verilerini tekrar istemciye gönderir. Aşağıda REST API'lerini daha ayrıntılı inceleyelim.

REST, Temsili Durum Aktarımı anlamına gelen Representational State Transfer ifadesinin kısaltmasıdır. REST, istemcilerin sunucu verilerine erişirken kullanabilmesi için GET, PUT, DELETE gibi belirli işlevler kullanır. İstemciler ve sunucular, HTTP üzerinden veri alışverişi yapar.

REST API'sinin ana özelliği durumsuz olmasıdır. Durumsuz olması, sunucuların istekler arasında istemci verilerini kaydetmemesi anlamına gelir. İstemcinin sunucuya gönderdiği istekler, bir web sitesini ziyaret etmek için tarayıcınıza yazdığınız URL'lere benzer. Gelen yanıt ise bir web sayfasında görmeye alışık olduğumuz grafikleri içermeyen sade verilerdir.

Bir Web API'si veya Web Hizmeti API'si, bir web sunucusu ile web tarayıcısı arasındaki uygulama işleme arabirimidir. Tüm web hizmetleri birer API'dir ancak tüm API'ler web hizmeti değildir. REST API'leri, yukarıda açıklanan standart mimari stilini kullanan özel bir Web API'si türüdür.

API'lerle ilgili olarak Java API'si veya hizmet API'leri gibi farklı terimlerinin olmasının sebebi, API'lerin World Wide Web'den önce oluşturulmuş olmalarıdır. Modern web API'leri birer REST API'sidir ve terimler birbirinin yerine kullanılabilir.

REST API'lerinin sunduğu dört temel avantaj vardır:

API'ler, hem mimarilerine hem de kullanım kapsamlarına göre sınıflandırılır. Ana API mimarisi türlerini zaten incelediğimize göre, şimdi de kullanım kapsamına göz atalım.

API uç noktaları, API iletişim sistemindeki nihai temas noktalarıdır. Bunlara sunucu URL'leri, hizmetler ve bilgilerin sistemler arasında gönderilip alındığı diğer belirli dijital konumlar dahildir. API uç noktalarının kurumlar için kritik öneme sahip olmasının iki ana sebebi vardır: 

Tüm API'ler, uygun kimlik doğrulama ve izleme faaliyetleriyle güvenceye alınmalıdır. REST API'lerini güvenceye almanın en temel iki yöntemi şunlardır:

Diğer geliştiricilerin kullanmak isteyeceği ve güveneceği bir API oluşturmak, büyük özen ve emek isteyen bir iştir. Yüksek kaliteli API tasarımı için gerekli beş adım şunlardır:

API test etme stratejileri, diğer yazılım test etme metodolojilerine benzer. Ana odak noktası, sunucu yanıtlarını doğrulamaktır. API testleri şunları içerir:

• Performans testi için API uç noktalarına birden fazla istek göndermek.
• İş mantığını ve işlevlerin doğruluğunu kontrol etmek için birim testleri yazmak.
• Sistem saldırılarını simüle ederek güvenlik testleri yapmak.

Kapsamlı API belgeleri yazmak, API yönetimi sürecinin bir parçasıdır. API belgeleri, araçlar kullanılarak otomatik oluşturulabilir ya da manuel olarak yazılabilir. En iyi uygulamalardan bazıları şunlardır:

• Açıklamaları kolayca okunabilen, basit bir dille yazmak. Araçlar tarafından oluşturulan belgeler zor anlaşılabilir ve düzenleme gerektirebilir.
• İşlevleri açıklamak için kod örnekleri kullanmak.
• Belgeleri doğru ve güncel tutmak.
• Yazma tarzını belirlerken yeni başlayanları hedeflemek.
• API'nin kullanıcılar için çözebileceği tüm sorunlara yer vermek.

Yeni bir API'yi uygulama adımları şunları içerir:

1. Bir API anahtarı almak. Bunun için API sağlayıcısının sisteminde doğrulanmış bir hesap oluşturulur.
2. Bir HTTP API istemcisi ayarlayın. Bu araç, aldığınız API anahtarlarını kullanarak API isteklerini yapılandırmanıza olanak tanır.
3. Bir API istemciniz yoksa API belgelerine başvurarak isteği tarayıcınızda kendiniz yapılandırmaya çalışabilirsiniz.
4. Artık aşinalık kazandığınız yeni API söz dizimini kodunuzda kullanmaya başlayabilirsiniz.

Yeni web API'lerini API pazar yerlerinde ve API dizinlerinde bulabilirsiniz. API pazar yerleri, isteyen herkesin bir API'yi kaydettirerek satabildiği açık platformlardır. API dizinleri, dizin sahibinin yönettiği, denetimli depolardır. Uzman API tasarımcıları, dizinine eklemeden önce bir API'yi değerlendirebilir ve test edebilir.  

Popüler API web sitelerinden bazıları şunlardır:

• Rapid API - Sitedeki 10.000'den fazla genel API ve 1 milyon aktif geliştirici ile en büyük küresel API pazarıdır. RapidAPI, kullanıcılara satın alma kararını vermeden önce API'leri doğrudan platform üzerinde test etme imkanı sunar.
• Public APIs - API'leri 40 niş kategori altında gruplandıran bu platform, gezinmenizi ve ihtiyaçlarınıza en uygun olanı bulmanızı kolaylaştırır.
• APIForThat ve APIList - Bu web sitelerinin ikisinde de 500'ün üzerinde web API'si ve nasıl kullanılacaklarına dair derinlemesine bilgiler bulunur.                                                                                                

Bir API Ağ Geçidi, çok sayıda arka uç hizmeti kullanan kurumsal müşteriler için bir API yönetimi aracıdır. API ağ geçitleri genellikle kullanıcı kimlik doğrulaması, istatistikler ve hız yönetimi gibi tüm API çağrıları için geçerli olan yaygın görevleri üstlenir.

Amazon API Gateway, geliştiriciler tarafından istenen ölçekte API'ler oluşturulup yayımlanmasını, bunların izlenmesini, bakımının yapılmasını ve güvenliğinin sağlanmasını mümkün kılan, tam olarak yönetilen bir hizmettir. Trafik yönetimi, CORS desteği, yetkilendirme ve erişim denetimi, kısıtlama, izleme ve API sürüm yönetimi dahil olmak üzere binlerce eş zamanlı API çağrısının kabul edilip işlenmesi için gerekli olan tüm görevleri üstlenir.

GraphQL, API'ler için özel olarak geliştirilmiş bir sorgu dilidir. Önceliği, istemcilere tam olarak istedikleri veriler dışında başka hiçbir şey vermemektir. API'leri hızlı, esnek ve geliştirici dostu hale getirmek amacıyla tasarlanmıştır. REST'in bir alternatifi olan GraphQL, ön uç geliştiricilere çoklu veritabanlarını, mikro hizmetleri ve API'leri tek bir GraphQL uç noktasıyla sorgulama imkanı tanır. Kuruluşlar, uygulamaları daha hızlı geliştirmelerine yardımcı olduğu için GraphQL ile API'ler oluşturmayı seçmektedir. Buradan GraphQL ile ilgili daha fazlasını okuyun.

AWS AppSync; AWS DynamoDB ve AWS Lambda gibi veri kaynaklarına güvenli bir şekilde bağlanmanın getirdiği ağır yük ile başa çıkarak GraphQL API'ler geliştirmeyi kolaylaştıran, tam olarak yönetilen bir hizmettir. AWS AppSync, gerçek zamanlı veri güncellemelerini WebSocket'ler üzerinden milyonlarca istemciye gönderebilir. Mobil uygulamalar ve web uygulamaları için AppSync, cihazlar çevrimdışı olduğunda yerel veri erişimi de sağlar. AWS AppSync, dağıtıldığında API istek hacimlerini karşılamak için GraphQL API yürütme altyapısının ölçeğini otomatik olarak büyütür ve küçültür.