API nasıl çalışır? APIyi uygulamaya nasıl entegre edebilirim?

Uygulama programlama arayüzü (API), akıllı uygulamalar oluşturmak için son gereksinimlerden biridir. İki uygulama arasındaki iletişim kanalıdır. Bilinçli ya da bilinçsiz olarak internette gezinirken ya da günlük yaşamınızda programları kullanırken bir noktada API kullanmışsınızdır.

API'ler genellikle karmaşık verileri yanıt olarak gönderir; peki bu bilgileri kullanıcılarınıza hizmet vermek için nasıl anlayabilir ve kullanabilirsiniz? API'ler hem deneyimli geliştiriciler hem de yeni başlayanlar için hayatı kolaylaştırır. Bu yüzden bunları uygulamanızda nasıl kullanacağınızı bilmeniz gerekir.

Bazı kullanım örnekleri ve örneklerle, geliştirici olarak programlarınıza hizmet vermek için API'leri nasıl kullanabileceğinize bakalım.

API nedir?

API'ler ayrı programların birbirleriyle etkileşim kurması için bir yol sağlar

API'ler ayrı programların birbirleriyle etkileşim kurması için bir yol sağlar. API'ler yapılabilecek istekleri, isteklerin nasıl yapılacağını tanımlar ve farklı yazılım uygulamaları arasında veri alışverişini sağlar.

API'ler 3 türde gelir: Genel, özel ve iş ortağı. Genel API'lere (veya açık API'lere) tüm geliştiriciler genel olarak erişebilir. Genel API'lerin kullanılması bazı sınırlamalarla birlikte gelir ve bunlar ücretsiz veya ticari olabilir. Özel API'ler yalnızca bir şirket veya kuruluş içinde kullanılır. İş Ortağı API'leri yalnızca belirli iş ortakları tarafından kullanılabilir ve en sık iki farklı işletme arasındaki yazılım entegrasyonunu kolaylaştırmak için kullanılır.

API nasıl çalışır?

Geliştiriciler, diğer geliştiricilere hizmet edebilecek ürünler olarak API'ler oluşturur. Amaç, karmaşık web geliştirme süreçlerini tüketici geliştiricileri veya işletmeler için daha kolay, daha verimli ve daha hızlı hale getirmektir.

Artık çoğu işletme, sorunları çözmek ve müşterilerine daha iyi hizmet vermek için üçüncü taraf API'lere güveniyor. Ancak API'yi kullanmak pek çok kişinin düşündüğü kadar karmaşık değil. Belirli bir HTTP isteği yaptığınızda size veri biçiminde belirli bir yanıt veren üçüncü taraf bir çözüm olarak düşünebilirsiniz.

API'yi kullanmak bir pizza restoranında sipariş vermek gibidir. Onlara ne istediğini söylemek için mutfağa gidemezsin. Siparişinizi alıp mutfağa teslim edecek ve ardından istediğiniz pizzayla geri dönecek bir garsona ihtiyacınız var.

API'yi sizinle mutfak arasındaki bağlantı olarak düşünebilirsiniz. Bu durumda, garson sağlayan bir restoranı (API) ziyaret eden bir müşterisiniz. Garson daha sonra pizza seçiminizle (verilerle) yanıt verecektir. Gerçek bir API'de web uygulaması, HTTP uç nokta istekleri yaparak sağlayıcının içeriğini API aracılığıyla tüketmeyi talep eden istemcidir.

API nasıl kullanılır?

API'ler birçok durumda kullanılır

API'ler, Veritabanı API'leri, Uzak API'ler ve Web API'leri gibi kategoriler de dahil olmak üzere birçok senaryoda kullanılır. Akıllı telefonunuzda veya bilgisayarınızda gezinirken büyük olasılıkla web API'leriyle günde birkaç kez etkileşimde bulunuyorsunuz. Web API'leri HTTP protokolünü kullanarak istek ve veri alışverişinde bulunur.

Skyscanner ve Booking.com gibi seyahat rezervasyon siteleri, müşteriler için uçuş ve varış noktası verilerini toplamak amacıyla web API'lerini kullanır. Web API'lerinin rahatlığı, otelden taleplerinizi ve verilerinizi anında alıp göndererek otel odasının müsaitliğini ve kalış sürenizi gerçek zamanlı olarak doğrulamanıza olanak tanır.

API uç noktası nedir?

Bir API'ye bağlanmak, programınızı bir API uç noktasına bağlamanızı gerektirir. Bunu iki yönlü bir bağlantı olarak düşünebilirsiniz. Programınıza bağlı uç nokta isteği gönderirken API'ye bağlı uç nokta size belirli bir yanıt gönderir.

Uç nokta bir istek URL'sidir ve istemciye bir API'nin kaynaklarına doğrudan erişim sağlar.

API kullanarak veri almanın yanı sıra, sağlayıcıdan istemciye istekleri POST edebilir, sağlayıcıdan daha fazla bilgi almak için PUT yöntemini kullanabilir ve ayrıca programınızdan mevcut verileri silmek için DELETE yöntemini kullanabilirsiniz. Bu yöntemlerin her biri genellikle API'nin belgelerinde bulunur.

API'ye bağlanma kriterleri

Bir API'yi programınıza entegre etmek yalnızca anlık bir karar değil, önceden tasarlanmış bir karardır. İstediğiniz bilgiyi ve miktarı bilmelisiniz. Bu, özellikle JSON verilerini çok boyutlu bir dizi olarak işliyorsanız karmaşıklığın azaltılmasına yardımcı olur. Ayrıca programınız için ihtiyaç duyduğunuz spesifik bilgileri almanızı da sağlar.

Onlara bağlanmak için farklı kurallara sahip yüzlerce API var. Bazı API'ler ücretsiz ve açık kaynak olsa da diğerlerine yalnızca abonelik esasına göre erişilebilir.

Bazı API'ler sorunsuz ve basit olup herhangi bir ön koşul gerektirmese de diğer API'ler, uç noktaya bağlanabilmeniz için önce bir API anahtarı oluşturma veya bir geliştirici hesabına kaydolma gibi koşulları karşılamanızı gerektirebilir.

Ancak herhangi bir API'nin en önemli yönlerinden biri dokümantasyonudur. Bağlanmayı planladığınız herhangi bir API'nin kaynaklarını nasıl kodlayacağınıza ve kullanacağınıza ilişkin talimatlar için belgelerini okuyup takip etmek en iyisidir. Bunun nedeni, her API'nin kendi bağlantı yöntemlerine ve talimatlarına sahip olmasıdır.

Herhangi bir API'ye bağlanmak için desteklediği programlama dillerini de bilmeniz gerekir.

Bir API'ye nasıl bağlanılır: Pratik örnek

API'ye bağlanmanın belirli bir yolu yoktur, ancak bazı örnekler size API verilerini uygulamanızda nasıl kullanabileceğinizin temellerini gösterecektir.

Bir API'ye nasıl bağlanabileceğinizi gösteren bazı kısa örnek kodlara bakalım.

Iro.Js Renk Seçici API'si nasıl kullanılır?

Iro.js, web sitenize ücretsiz bir renk seçici eklemenizi sağlayan basit bir API'dir. Renk tekerleğinde bir nokta seçtiğinizde API, o rengin onaltılık veya RGB kodunu döndürür. iro.js API'sine bağlanmak için tek yapmanız gereken CDN (İçerik Dağıtım Ağı) uç noktasını DOM'un başına yapıştırmak.

Bu API'nin tam belgelerine iro.js.org adresinden ulaşılabilir:

https://iro.js.org/guide.html

Aşağıdaki örnek kodla bu API'ye nasıl bağlanabileceğinizi görelim:

Display color picker

Yukarıdaki örnek API durumunda, ona bağlanmak için bir API anahtarına ihtiyacınız yoktur. Ancak daha iyi anlamak için JavaScript'e daha yakından bakalım. Bu API'ye bağlanmak için iro sınıfından ColorPicker işlevini çağırmanız ve ardından renk tekerleği kabının kimliğini sınıfa aktarmanız yeterlidir.

Geliştiricileri kullanıcılar için katmanı kodlamak gibi ekstra bir çalışma yaptığından, iro.js API uç noktasına bağlanmak kolaydır. Aşağıdaki resim yukarıdaki örnek kodun sonucudur.

Örnek kodun sonucu

Renk değiştirme olayının nasıl gerçekleştiğini görmek için başka bir HTML dosyası açıp aşağıdaki kodu bu dosyanın komut dosyaları bölümüne yapıştırabilirsiniz :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Yukarıdaki kod, tekerlek üzerindeki renk seçicinin konumunu her değiştirdiğinizde onaltılık renk değerlerini kaydeder.

NoCodeAPI Döviz Değişim API'si nasıl kullanılır?

NoCodeAPI, para birimi dönüştürme API'si de dahil olmak üzere birçok API sağlar. Bu döviz bozdurma uç noktasına bağlanmak için NoCodeAPI'yi ziyaret edin ve bir hesap oluşturun:

https://app.nocodeapi.com/login

Giriş yaptığınızda sayfanın üst kısmında bir arama çubuğu bulunur. Bu arama çubuğuna döviz kuru yazın , sorgunuz göründüğünde Etkinleştir'i tıklayın.

Sonraki sayfada Döviz Alım Satım API'si Yap'a tıklayın . Daha sonra API için bir ad girin ve Oluştur'a tıklayın.

API'yi oluşturduktan sonra Belgeleri Görüntüle'ye tıklayın. Ardından, API uç noktasına bağlanan kodu görüntülemek için tercih ettiğiniz dili seçin. Daha sonra bu örnek kodu kopyalayıp daha fazla özelleştirme için uygulamanıza yapıştırabilirsiniz.

Para birimi dönüştürme için aşağıdaki örnek koda bakın: