API nedir? [Hızlı Okuma]

Geliştirici değilseniz, ancak teknoloji alanında çalışıyorsanız, API terimi muhtemelen konuşma anlamında anladığınız bir şeydir. Muhtemelen bunun ne anlama geldiğini biliyorsunuzdur (uygulama programlama arayüzü) ve belki ekipleriniz işlerini yapmak için API'leri kullanıyordur veya belki de ürünün kendisidir (örneğin Twilio SendGrid).

Peki API tam olarak nedir ve nasıl çalışır?

API'lerin ardındaki daha derin ilkeleri anlamak, bu teknolojileri kendiniz daha iyi pazarlamanıza, satmanıza veya kullanmanıza yardımcı olacaktır.

Bu gönderi, API'lerin nasıl çalıştığını, geliştiricilerin bunları nasıl oluşturduğunu ve nasıl kullanılacağını (gerçek dünyadan örneklerle) açıklar.

API'ler nasıl çalışır?

Web tarayıcılarının sunucularla nasıl etkileşime girdiği, API'lerin temel bir ilkesidir. Web, gezegene dağılmış bir uzak sunucular topluluğudur. Bir tarayıcı açtığınızda ve bir web sitesi yazdığınızda, tarayıcı, o URL'de yaşayanları almak ve görüntülemek için müşterinin sunucusuna (bir web sitesinin barındırıldığı uygulama veya sunucu ne olursa olsun) bir çağrı yapar.

API, sunucunun kendisi olmasa da, belirli yanıtları gönderen ve alan, sunucunun uç nokta olarak bilinen kısmıdır. API'ler, farklı yazılım parçalarının uç noktaları açarak birbirleriyle iletişim kurmasının (yani gönderme ve alma) bir yoludur.

Geliştiriciler, uygulamalar veya web siteleri oluştururken çeşitli amaçlar için ihtiyaç duyulan belirli verileri almak için API çağrıları kurar. Örneğin:

• Instagram uygulamanızı yeni mi açtınız? Bu bir API çağrısı ile mümkün oldu.
• Google Takviminize başka bir web sitesinden veya e-postadan bir etkinlik eklediniz mi? Bu site, belirli bilgileri Google Takvim sunucusundan almak için Google Takvim API'sinden yararlanıyordu.

Paket Servis: Geliştiriciler, bir kullanıcı bir web sitesindeyken veya bir uygulamayı çalıştırırken ihtiyaç duyduklarını görüntülemek için belirli veri türlerini almak için API çağrıları kurar.

REST'in Yükselişi

Muhtemelen duymuş olduğunuz başka bir terim de REST API'dir. Bir API'nin geleneksel tanımından farklı değildir. Yine de REST API'lerinin neden bu kadar popüler hale geldiğini ve REST API'lerini diğerlerinden ayıran şeyin ne olduğunu anlamaya değer.

Başlangıçta, API'ler SOAP'ın (Basit Nesne Erişim Protokolü) gereksinimlerini karşılamak için oluşturuldu. Ancak bu yöntem biraz sıkıcıydı ve veri kümelerini aktarmak için çok fazla bant genişliği gerektiriyordu. Aynı zamanda çok fazla geliştirici enerjisi talep etti (eğlenceli türden değil). SOAP, verileri görüntülemek için ünlü ağır XML biçimlendirme dilini kullanır. Evrensel uyumluluğu sağlamak için kullanışlıdır, ancak hepsi bu kadar.

Geliştiriciler, API çağrıları yapmak için daha hafif ve daha esnek yollar arıyorlardı. REST (temsili durum aktarımı) API'leri, SOAP API'sine alternatif bir çözüm sunar. Belirli bir protokol tarafından kısıtlanmazlar, ancak belirli mimari tarzları karşılamaları gerekir (bununla ilgileniyorsanız, buraya gidin).

Sunucu, XML işaretlemesiyle görüntülenmek yerine, bunun yerine hafif JSON dilini (yalnızca metin dosyaları) kullanır. REST API'leri bant genişliği açısından SOAP'tan çok daha hafiftir (genellikle yalnızca bir URL'dir) ve web üzerinde iletişim için doğal olarak optimize edilirler.

Paket Servis: REST API'lerini verilerin Marie Kondo'su olarak düşünün. Yalnızca *tam olarak* ihtiyaç duyduklarını alır ve kullanırlar. SABUN API'leri, şu anda ağzına kadar tuvalet kağıdıyla dolu olan komşunuzun garajı gibidir.

Farklı API türlerini anlama

Bir API'nin izlediği protokol veya stillerden bağımsız olarak, aşağıdakiler dahil çeşitli API türleri vardır:

• Açık API'ler – Genel API'ler olarak da bilinen bu uç noktalara herhangi bir geliştirici tarafından erişilebilir ve genellikle kullanıcıya herhangi bir kısıtlama getirmez. Genellikle bağış kabul ederler.
• İş Ortağı API'leri – Bunlar, birlikte kullanılmak üzere tasarlanmış API'lerdir ve genellikle yalnızca bir tür pazar tarafından erişilebilir.
• Dahili API'ler – Bunlar, şirketlerin çalışanlarının daha verimli olmalarına yardımcı olmak veya çalışanların veri/bilgi paylaşmaları için daha güvenli bir yol sağlamak için kullandıkları dahili araçlardır.
• Bileşik API'ler – Bileşik API'ler, ilgili ancak normalde ayrı API çağrıları gerektiren API çağrılarını birleştirmenin bir yoludur.

API'lerin gerçek hayattan örnekleri

Kullanıcıların çeşitli uygulamalara erişmesine yardımcı olan çok sayıda API vardır (bazıları 15.000'den fazladır). Aşağıda, API ekosisteminin kapsamını anlamanıza yardımcı olacak dikkate değer birkaç tanesi bulunmaktadır.

Kokteyl DB'si

Diyelim ki yerel bir içki dükkanınız var ve web sitenizde kokteyl tarifleri sunmak istiyorsunuz. Yukarıdaki Cocktail DB API'sini kullanmayı düşünebilirsiniz. Tüm bu veriler (kokteyl tarifleri) başka birinin sunucusunda zaten var ve API aracılığıyla değerlendirilebilir.

Bir kullanıcı margarita tariflerine tıkladığında (muhtemelen üstün kokteyl), sunucuları belirli tarifin onu JSON'da gönderdiğini bulur, web sitesini alır ve web sitesi tarayıcınızda sunulabilmesi için HTML ve CSS'ye ayrıştırılır.

OpenWeatherMap

Web sitenize bir hava durumu bölümü eklemek çok yaygın bir kullanım durumudur. Herhangi bir kayak merkezini, bisiklet mağazasını veya tur şirketini düşünün. OpenWeatherMap API, tüm hava durumu tahminlerini ve bilgilerini saklar ve yalnızca talep ettiğiniz kısmı görüntüler.

Bu API, ne kadar veri görüntülemek istediğinize bağlı olarak hem ücretsiz hem de premium sürümler sağlar.

SendGrid E-posta API'sı

SendGrid Email API, müşterilerin büyük miktarlarda işlemsel ve tetiklenmiş e-posta göndermesine olanak sağlamak için SMTP'den (basit posta aktarım protokolü) yararlanır; örneğin parola sıfırlama, hesap onayı ve gönderim bildirimlerini düşünün.

Twilio SMS

Twilio SMS API, uygulamalara mesajlaşma özellikleri eklemenin bir yolunu sağlayan başka bir REST API'dir. SMS mesajlaşma, markaların müşterilerle iletişim kurmasının bir yolu olarak giderek daha popüler hale geldi çünkü kişisel, gerçek zamanlı ve bu mesajlar çok daha yüksek oranlarda okunuyor.

API nasıl kullanılır

Siz veya ekibiniz API'leri kullanmaya başlamadan önce, API'lerin açık mı, bir iş ortağı hizmetiyle birlikte mi yoksa bir bileşik mi olduğunu bilmek önemlidir.

API kullanmaya nasıl başlanır?

Belgeleri okuyun. Herhangi bir API, takip etmeniz için geçerli belgelere sahip olmalıdır. Hangi bağımlılıklara sahip olduğunuzu, ne tür bir API olduğunu ve nasıl kullanılacağını size söyleyecektir. Kötü belgeler, siz ve geliştiriciniz için bir tehlike işareti olmalıdır. Twilio ve SendGrid'in mükemmel belgeleriyle oldukça gurur duyuyoruz.

Bir API anahtarı oluşturun. Kullanmaya başlamak için bir API anahtarı oluşturmanız gerekecek. Google Haritalar API'sinden gelen talimatlar:

Not : API anahtarlarını asla paylaşmayın ve GitHub'a koyduğunuz herhangi bir genel kodda görünmediğinden emin olun.

Oluşturmaya başlayın: SendGrid Email API ile ücretsiz e-posta gönderin

Gerisi size kalmış! API'lerle çalışırken fırsatlar gerçekten sonsuzdur. Twilio API ile çalışmak için tüm fırsatlara göz atmak için Twilio Code Exchange'e göz atın.

Ücretsiz e-posta göndermek için SendGrid E-posta API'sini kullanmakla ilgileniyorsanız, buradan kontrol edin.