Endpoint nedir?

Endpoint, yani uç nokta, bir API içinde belirli bir işleve karşılık gelen adrestir. Bir API’yi bir binaya benzetirsek, her endpoint o binadaki ayrı bir kapıdır ve her kapı farklı bir işe açılır. Örneğin siparişler adresi tüm sipariş listesini döndürürken, siparişler bölümüne eklenen 42 numarası yalnızca o tek siparişi getirir.

Uygulamalar bu uç noktalara istek gönderir ve cevabı çoğunlukla JSON biçiminde, yani düzenli ve makinenin kolayca okuyabileceği bir formatta alır. Bir REST API tasarlanırken her kaynak için ayrı bir endpoint tanımlanır. Hangi kapının ne iş yaptığı, ne beklediği ve ne döndürdüğü dokümantasyonda açıkça yazılır, böylece o API’yi kullanacak geliştirici yolunu şaşırmaz.

Güvenlik de tam burada başlar. Her endpoint kimlik doğrulamasından geçirilmelidir, aksi halde veriye açılan kapıyı herkese açık bırakmış olursunuz. Yetkisiz bir isteğin hassas bilgilere ulaşamaması, her uç noktanın kim olduğunuzu ve neye izniniz olduğunu kontrol etmesiyle sağlanır. Karşı sistemin size kendiliğinden veri gönderdiği durumlarda ise devreye webhook girer.