API

API sözü Application Programming Interface demektir. Basitçe, hazır konuşma kuralıdır. Bir taraf sorar, öteki taraf kurala göre cevap verir. Hava sitesinin içindeki tabanı görmezsin. Ona bir adres gönderirsin, o da bugünkü ısıyı yazı ya da JSON olarak döndürür. Harita, ödeme ve çeviri de aynı yolla sorulur. API kendi dil değildir. Python da değildir, JavaScript de değildir. İki programın sözleştiği yoldur. Yol değişirse eski sorunun cevabı da değişebilir. Bu yüzden belgeye bakmak gerekir.

API başka yerde duran hazır işi senin programına getirir. Her şeyi sıfırdan yazmazsın.

• Havayı veya kuru sormak
• Ödemeyi başka hizmete bırakmak
• Sitenin kendi verisini telefona vermek
• İki programın aynı tabana dokunmadan konuşması

API ile soru gönderir ve cevabı okursun. Çoğu zaman adres bir yoldur, yöntem ise GET ya da POST’tur. GET okumak içindir. POST yeni bir şey göndermek içindir. Cevap çoğu zaman JSON’dur: anahtar ve değer. O yazıyı kendi sayfanda gösterirsin. API sayfayı çizmez ve düğmeye basmaz. Anahtarı olan kapı herkese açık değildir. Anahtarı sayfanın içine yazarsan bakan kişi onu alır. Anahtar sunucuda kalmalıdır.

Bir açık adresten hava okumak kolaydır. Zorluk kural ve anahtardadır. Adres bir harf değişirse eski sorgu kırılır. Limit olabilir: günde belli sayıdan sonra cevap gelmez. Cevap boş, yanlış veya geç olabilir. Bunu yoklamadan sayfaya basmamak gerekir. Başkasının anahtarıyla sorgu para ya da veri götürebilir. Belgede ne sorulur, ne yasaktır, onu okumadan işe başlamamak gerekir.

API hazır işi sana getirir ve içeriyi gizler. Bu, hızdır. Bedeli bağımlılıktır. Karşı taraf adresi değiştirirse veya limiti kapatırsa senin programın da durur. Her şeyi kendin yazarsan az bağlısın, ama çok iş yazarsın. Küçük site için hazır API düz yoldur. Anahtarı ise herkesin gördüğü yere hiç koyma.

API kapıdır. Adres sorunun yeridir. JSON ise cevabın yazı biçimidir.

• Program programa sorar, insan düğmeye basar
• GET okur, POST gönderir
• Cevap çoğu zaman JSON olur
• Anahtar herkesin gördüğü sayfaya yazılmaz

Bu, bir kullanıcıyı okumak için adresin basit halidir. Cevap genellikle JSON gelir.

GET /users/12

{
  "id": 12,
  "name": "Nibras"
}

• API programlama dili mi? Hayır. İki programın konuşma kuralıdır. Python ve JavaScript onu çağıran dil olabilir.
• API ve site aynı mı? Hayır. Siteyi insan okur. API’yi program okur. İkisi aynı veriden gelebilir.
• Anahtarı sayfaya yazmak olur mu? Hayır. Bakan kişi onu alır. Anahtar sunucuda kalmalıdır.