API'nin anlamı nedir?

Uygulama Programlama Arayüzü'nün kısaltması olan API, uygulamaların belirli verilere erişmesine ve harici yazılım uygulaması bileşenleri, işletim sistemleri veya mikro hizmetlerle etkileşime girmesine olanak tanıyan bir dizi işlev kodu anlamına gelir.

Basitleştirmek gerekirse, bir API, sisteme bir kullanıcı yanıtı iletir ve sistemin yanıtını kullanıcıya geri gönderir. "Sepete ekle"yi tıklarsınız; bir API, siteye sepetinize bir ürün eklediğinizi bildirir; web sitesi ürünü sepetinize koyar ve sepetiniz güncellenir.

API ile ilgili olarak “mikro hizmetler” teriminin gündeme geldiğini duyabilirsiniz. Ancak bunlar aynı değildir. Mikro hizmetler, bir web uygulaması içindeki işlevselliği bölen bir stil veya mimaridir. API, geliştiricilerin bir web uygulamasıyla etkileşime girdiği çerçevedir. Mikro hizmetler aslında iletişim kurmak için API'yi kullanın birbirleri arasında.

API, geliştiricinin bilgi göndermek veya almak için belirli bir "çağrı" veya "istek" yapmasına olanak tanır. Bu iletişim “JSON” adı verilen bir programlama dili kullanılarak yapılır. Verileri güncellemek veya silmek gibi tanımlanmış bir eylemi gerçekleştirmek için de kullanılabilir. API ile yapılabilecek dört temel istek yöntemi vardır:

GET – Bilgi toplar (Tüm Kupon Kodlarını Çekme)

PUT – Veri parçalarını günceller (Ürün fiyatlandırmasını güncelleme)

POST – Oluşturur (Yeni bir Ürün Kategorisi Oluşturma)

DELETE – (Bir blog yazısını silme)

JSON Nedir ve Neden Kullanılır?

JSON (JavaScript Object Notation), bir sunucudaki verileri temsil etmek için kullanılır. İnsanlar tarafından okunması oldukça kolaydır ve makinelerin/uygulamaların anlaması kolaydır. BigCommerce'deki bir üründen JSON örneğine bakalım:

Solda anahtar ve sağda değer olacak şekilde anahtar/değer çiftleri halinde çıktılandığı için bunu anlamak kolaydır. Anahtarlar uygulama tarafından tanımlanan sabit bir nesnedir ve “kategori” ile aynı kalacaktır. Oysa değerler "Gömlekler" gibi benzersiz olacaktır.

API İsteği nedir?

Bir API İsteğinin çalışabilmesi için çeşitli bileşenleri vardır. Bunları ayrı ayrı ele alalım ve bunların bir istek oluşturmak için nasıl kullanılabileceğini ele alalım.

Uç Nokta Nedir?

Bir API isteğinde bulunurken kullanılan uç noktanın iki önemli bölümü vardır. Bunlardan biri URL'dir. BigCommerce, tüm API İsteklerinin URL'si olarak https://api.bigcommerce.com/stores/ adresini kullanır. Bu normal bir URL gibi görünebilir ancak bunu bir web tarayıcısına bağlarsanız 404 hata mesajı alırsınız.

İkinci kısım ise yoldur. Yol, neyi başarmaya çalıştığınıza bağlı olarak değişecektir. Geliştirici belgelerimizi ziyaret ederek BigCommerce için mevcut yolların bir listesini bulabilirsiniz: https://developer.bigcommerce.com/api-reference. Bu örnek için /v3/catalog/products olan ürün yolunu kullanacağız.

Bu iki parçayı bir araya getirdiğimizde tam bir uç nokta elde ediyoruz https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products. Şimdi kendi kendinize "{store_hash} nedir?" "Bu nereden geldi?" diyor olabilirsiniz. Değişken olarak bilinen şey budur. Değişkenler bir uç noktaya yönelik benzersiz bileşenlerdir ve mağazanızın bilgilerine göre değişiklik gösterir. Bir değişkeni açık ve kapalı parantez “{ }” ile fark edebilirsiniz.

Başlık nedir?

Başlıklar istemciye ve sunucuya bilgi sağlar. Başlığın yaygın örnekleri arasında "Kimlik Doğrulama Belirteci" veya "İstemci Kimliği" gibi kimlik doğrulama bilgileri yer alır. Bu kimlik bilgileri, bir API Hesabı oluşturduğunuzda size otomatik olarak sağlanır. Diğer bir yaygın başlık ise sunucuya ne tür içeriğin gönderileceği konusunda bilgi veren “İçerik Türü” olarak anılır. Örneğin, yaygın olarak kullanılan içerik türü “application/json” olup, sunucuya JSON verilerini gönderdiğimizi bildirir.

Yöntem Nedir?

Yöntemler, bir istek gönderilirken gerçekleştirilen eylemlerdir. GET, PUT, POST ve DELETE'i tartıştığımız başlangıcı düşünün. Bunların hepsi API Yöntemleridir.

Veri nedir?

Yaygın olarak "gövde" olarak da adlandırılan istek verileri, bir sunucuya gönderilecek veya sunucu tarafından döndürülecek bilgilerdir. Önceki JSON tartışmasında API verilerinin bir örneğini görebilirsiniz. Bir isteğin metni bazen teslim edilmeden önce belirli bilgiler gerektirebilir. Bunun bir örneği, tek bir ürünü düzenliyorsanız, herhangi bir değişiklik yapılmadan önce Ürün Kimliğinin gerekli olmasıdır.

Daha fazla okuyun.