API nedir?

API, bir yazılımın başka bir yazılımın belirli işlevlerine veya verilerine hangi kurallarla erişebileceğini tanımlayan arayüzdür. Bir hizmetin iç yapısını bütünüyle bilmeden onunla çalışmayı sağlar. API yalnızca internette kullanılan bir bağlantı değildir; işletim sistemleri ve yazılım kütüphaneleri de API sunar.

İstek, yanıt ve veri sözleşmesi nasıl işler?

Bir hava durumu uygulaması, konum için veri ister ve aldığı yanıtı ekranda gösterir. Web API’lerinde isteğin adresi, yöntemi, başlıkları ve bazen gövdesi bulunur. Yanıt, veriyle birlikte işlemin sonucunu bildiren durum bilgisi içerir. JSON yaygın bir veri biçimidir; ancak API ile JSON aynı kavram değildir. Sözleşme, hangi alanların gerekli olduğunu ve hataların nasıl bildirileceğini belirler. Bir arayüzün sürümü değiştiğinde istemciler etkilenebilir. Gecikme, zaman aşımı ve hizmet kesintisi normal işletim koşullarında da ele alınmalıdır.

API anahtarı, yetkilendirme ve hız sınırı neden vardır?

Kimlik doğrulama isteği yapanı tanımaya, yetkilendirme ise hangi işlemleri yapabileceğini belirlemeye yarar. API anahtarı her durumda sınırsız yetki veren bir parola değildir; kapsamı ve kullanım amacı önemlidir. Gizli anahtarlar herkese açık tarayıcı koduna konulmamalıdır. Hız sınırları kaynakların aşırı tüketilmesini azaltır, fakat tek başına bütün kötüye kullanımı engellemez. Kullanıcıdan gelen veriler doğrulanmalı ve yanıtlar gereksiz kişisel bilgi içermemelidir. Önbellek hız sağlayabilir; değişmiş verinin eski yanıtla sunulması ihtimali de yönetilmelidir. API kullanımı, sağlayıcının koşullarına ve erişim haklarına bağlıdır.