Sözlük

API nedir?

API, iki yazılımın birbirine veri gönderip alması için tanımlanmış kurallar bütünüdür.

30 gün ücretsiz deneyin

API çağrısında istek, kimlik doğrulama, yanıt ve zaman aşımı adımları

API ne işe yarar

Bir yazılımın içindeki bilgiye başka bir yazılımın ulaşmasını sağlar.

Devamını oku

API olmadan tek yol elle aktarmadır; elle aktarma da gecikir ve yanlışlanır.

API nasıl çalışır

İstek ve yanıt döngüsüyle. Bir taraf belirlenmiş adrese soru sorar (“5 Ekim’de boş oda var mı”), diğer taraf makine okuyabilir biçimde cevap döner. Web tarafında bu döngü çoğunlukla HTTP üzerinden kurulur ve yanıt JSON biçiminde gelir.

Devamını oku

Her isteğin bir kimlik anahtarı vardır; anahtar olmadan API kapıyı açmaz.

Yanıt biçimi de tanımlıdır. Hangi alanın hangi adla geleceği baştan bellidir; taraflardan biri alan adını değiştirirse bağlantı sessizce bozulur, bu yüzden sürüm numarası kullanılır.

Zaman aşımı da tanımlanır. Karşı sistem beş saniyede yanıt vermiyorsa beklemeye devam etmek kullanıcıyı bekletmekten başka işe yaramaz; istek kesilir ve yeniden denenir.

API ile entegrasyon aynı şey mi

API bir arayüzdür, entegrasyon o arayüzün kurulmuş hâlidir. API üreticinin sunduğu kapı, entegrasyon sizin o kapıdan geçip iki sistemi çalışır biçimde bağlamanızdır.

Devamını oku

Bir ürünün “API’si var” demesi entegrasyonun hazır olduğu anlamına gelmez.

Bu ayrım satın alma kararında önemlidir. “API destekliyor” cümlesi, sizin sisteminizle çalıştığı anlamına gelmez; entegrasyonun kim tarafından, ne kadar sürede yapılacağı ayrıca sorulur.

Belgelendirme de ayrı bir iştir. API belgesi eksikse entegrasyon deneme yanılmayla yürür ve her sürüm değişikliğinde yeniden kırılır.

API sınırları neden vardır

Sağlayıcılar dakikada ya da günde kaç istek atabileceğinizi sınırlar. Sınır aşılınca istek reddedilir. Bu yüzden yoğun işlerde istekler kuyruğa alınır, aynı bilgi tekrar tekrar sorulmaz, gelen cevap kısa süreliğine saklanır.

Devamını oku

Hata durumu da tasarlanır. Karşı sistem yanıt vermezse ne olacağı baştan belirlenmezse kullanıcı boş ekranla kalır; doğrusu, son bilinen bilgiyi göstermek ve durumu bildirmektir.

Kaynak: IETF RFC 9110 — HTTP Semantics