Endpoint
- Türkçe karşılığı
- uç nokta
- Okunuşu
- endpoynt
Günlük kullanımda çoğunlukla İngilizcesi tercih edilir.
Kısaca
Endpoint, bir API'nin belirli bir kaynak veya eylem için istek alıp yanıt döndürdüğü, bir HTTP metoduyla birlikte kullanılan belirli bir URL'dir.
API endpoint nedir?
Endpoint, bir API'ye ulaşılabilecek belirli bir adrestir. Bir web API'sinde https://api.example.com/users gibi bir URL'dir ve genellikle bir HTTP metoduyla eşleştirilir; bu yüzden GET /users ile POST /users çoğunlukla farklı işler yapan iki ayrı endpoint sayılır.
Bir endpoint URL'si tipik olarak API'nin alan adını ve sürümünü içeren bir temel URL'den (https://api.example.com/v1 gibi), kaynağı adlandıran bir yoldan (/users/42 gibi) ve sonuçları filtreleyen ya da sıralayan isteğe bağlı sorgu parametrelerinden (?sort=name gibi) oluşur. API'nin dokümantasyonu her endpoint'i, beklediği veriyi ve döndürdüğü yanıtı listeler.
Bir API restoran menüsüyse her endpoint menüdeki tek bir kalemdir: sipariş edebileceğiniz belirli bir şey ve ne alacağınızın net bir tarifi. Tipik bir REST API'nin onlarca endpoint'i vardır; GraphQL API'si ise genellikle yalnızca bir tane sunar ve hangi verinin döneceğine sorgu karar verir.
İnsanlar bazen endpoint, route ve API terimlerini birbirinin yerine kullanır. API arayüzün tamamıdır, endpoint istemcilerin gözünden ona açılan tek bir giriş noktasıdır, route ise bir URL ile metodu, onu işleyen fonksiyona bağlayan sunucu tarafındaki kuraldır. Ağ ve güvenlikte endpoint, dizüstü bilgisayar ya da telefon gibi bir cihaz anlamına da gelebilir; bu farklı bir anlamdır.
Önemli noktalar
- Endpoint, bir API'nin istek kabul ettiği URL'dir.
- Aynı URL farklı HTTP metotlarıyla farklı endpoint'ler gibi davranabilir.
- Endpoint URL'leri bir temel URL, bir kaynak yolu ve isteğe bağlı sorgu parametrelerinden oluşur.
- REST API'lerin çok sayıda endpoint'i vardır; GraphQL API'lerinin genellikle bir tane.
Örnek
// Each route below defines one endpoint of a users API (Express.js)
app.get("/v1/users", listUsers); // GET /v1/users
app.get("/v1/users/:id", getUser); // GET /v1/users/42
app.post("/v1/users", createUser); // POST /v1/users
app.patch("/v1/users/:id", updateUser); // PATCH /v1/users/42
app.delete("/v1/users/:id", deleteUser); // DELETE /v1/users/42
// A client calling one of those endpoints
const res = await fetch("https://api.example.com/v1/users/42");Sık sorulan sorular
API ile endpoint arasındaki fark nedir?
API, bir servisin sunduğu arayüzün tamamıdır; endpoint ise o API içindeki belirli bir URL ve metottur. Örneğin bir hava durumu API'sinin anlık durum ve tahminler için ayrı endpoint'leri olabilir.
Endpoint ile route arasındaki fark nedir?
Aynı şeyi farklı taraflardan tarif ederler. İstemciler bir endpoint'i çağırır; route ise o URL ve HTTP metodunu onu işleyen koda eşleyen sunucu tarafındaki kuraldır.
İlgili sayfalar
- APIBackend ve API'ler, s. 2API, bir yazılımın başka bir yazılımdan veri ya da işlem talep etmesini sağlayan, belgelenmiş ve öngörülebilir kurallar bütünüdür.
- REST APIBackend ve API'ler, s. 38REST API, verileri URL'lerle tanımlanan kaynaklar olarak sunan ve istemcilerin onları standart HTTP metotlarıyla okuyup değiştirmesini sağlayan web API'sidir.
- GraphQLBackend ve API'ler, s. 18GraphQL, istemcilerin tam ihtiyaç duyduğu veriyi, çoğunlukla tek bir endpoint üzerinden tek istekte istemesini sağlayan API sorgu dili ve çalışma zamanıdır.
- HTTPWeb Geliştirme, s. 20HTTP, tarayıcıların, uygulamaların ve sunucuların basit bir istek-yanıt döngüsüyle web sayfaları ve veri alışverişi yapmasını sağlayan protokoldür.
- WebhookBackend ve API'ler, s. 47Webhook, bir uygulamanın, tamamlanan bir ödeme gibi belirli bir olay gerçekleştiği anda sizin verdiğiniz bir URL'ye otomatik olarak gönderdiği HTTP isteğidir.
Bu sayfada bir hata ya da eksik mi gördünüz?Düzeltme önerin