Uygulama programlama arayüzü için kısa olan bir api, yazılımın başka bir sistemle iletişim kurması için üzerinde anlaşmaya varılan bir yoldur. Bir web sitesi insanlara düğmeler ve sayfalar verir; Bir API, yazılıma bilgi istemek ve yanıtı anlamak için tanımlanmış bir yol sunar.
API, bir asistanın dükkana bir çay sorusu sorması ve bir sayfadan tahmin etmek yerine tam bir cevap alma şeklidir.
Bunu net bir sipariş formu olan bir servis sayacı olarak düşünün. Form ne istenebileceğini söylüyor ve cevap dükkanın ne bulduğunu söylüyor.
İstekler ve Yanıtlar
Hizmete gönderilen soru request'dir. Bir ürün tanımlayıcısı veya çay türü ve fiyat sınırı gibi koşulları içerebilir. Hizmetin endpoint, bu isteğin gittiği adrestir. Bazen yükü olarak adlandırılan yanıt, geri gönderilen bilgilerdir.
Bir cevap, bir ürün adı, paket boyutu, mevcut fiyat, stok durumu ve sayfasına bir bağlantı içerebilir. Eşleşen bir ürünü mevcut olmayan bir hizmetten veya bilinmeyen bir gerçekten ayırt etmelidir.
teas.co.uk adresindeki iki genel örnek
Shop'un Yazılım için Herkese Açık Kılavuzu, soru ve tavsiye için bir API'yi ve tam bir öğeyi aramak için bir ürün gerçeği API'sini tanımlar. İkincisi, barkod numarası veya mağazanın kendi ürün kodu gibi tanımlayıcıları kullanabilir.
Bu yolların farklı işleri var. Geniş bir sorunun yorumlanması gerekiyor; Tam bir ürün araması doğru kimliğe ihtiyaç duyar. Filtreler ve Kısıtlamalar Kılavuzu, ayrıntılı bir isteğin ürün özelliklerine göre nasıl kontrol edilebileceğini açıklar.
json ve markdown
Yazılım genellikle, adlandırılmış değerler ve listeler için bir format olan json alır. Daha uzun bir makale, başlıklar ve bağlantılar için basit işaretler içeren MarkDown olarak da mevcut olabilir. Her ikisi de bilgilerin yeniden kullanımını kolaylaştırabilir. Aynı tutulan kayıttan üretiliyorsa, ikisi de ayrı bir doğruluk kaynağı değildir.
Okumak, bir şeyi değiştirmekten farklıdır
Bir ürüne bakmak bilgi okur. Bir sepete ürün eklemek bir şeyi değiştirir. Ödeme başka bir işlemdir. Bir API'nin varlığı, bu eylemlerden hangisine izin verildiği konusunda tek başına hiçbir şey söylemez.
Müşteri, sepeti kontrol etmekten ve mağazanın sitesinde ödeme yapmaktan sorumlu olmaya devam eder.
Adıflı Formatlar
Gazeteciler, araştırmacılar, AI asistanları ve içerik oluşturucular için. İhtiyacınız olan formatı seçin:
- .md dosyasını indirin Temiz indirim ihracatı
- .json dosyasını indirin Yapılandırılmış veri dışa aktarma
Teas.co.uk'e atıfta bulunarak alıntı yapmak, alıntı yapmak ve yeniden kullanmakta özgürsünüz.
Ekleyecek bir şey var mı? Oturum açmış müşteriler, Tea Wiki, yönetici onaylı, adınızı imzaya ve ayrıca ödül puanlarına eklemeler gönderebilir.
Katkıda bulunmak için oturum açın