HTTP Protokolünde REST API
Genellikle web siteleri oluşturulurken veri almak, oluşturmak, değiştirmek ve silmek için sadece GET ve POST yöntemleri kullanılır, çünkü bunlar tarayıcılar ve sunucular tarafından iyi desteklenir. Aynı durum, web siteleri tarafından sağlanan API'lar için de geçerlidir. Ancak, hem API geliştiricileri hem de kullanıcıları için genel kolaylık sağlayan, API'ı standartlaştıran özel yaklaşımlar mevcuttur.
Bu yaklaşımlardan biri REST API'dır (genellikle RESTful denir ve bu kelime bir sıfat olarak kullanılır). Bu API'nın temelinde HTTP protokolü yöntemlerinin geniş kullanımı yatar. Bu yaklaşımda, GET yöntemi ile veriler alınır, POST yöntemi ile oluşturulur, PUT yöntemi ile değiştirilir ve DELETE yöntemi ile silinir.
Örnek olarak, kullanıcılar üzerinde işlem yapan bir API'yı ele alalım. Çeşitli eylemler için URL'lerin nasıl görüneceğine bir bakalım.
Tüm kullanıcıları alıyoruz:
GET http://api.loc/users/
Kullanıcıyı id'sine göre alıyoruz:
GET http://api.loc/user/1/
Kullanıcı oluşturuyoruz:
POST http://api.loc/user/
Kullanıcıyı id'sine göre değiştiriyoruz:
PUT http://api.loc/user/1/
Kullanıcıyı id'sine göre siliyoruz:
DELETE http://api.loc/user/1/
Bir internet mağazası ürün API'nız olduğunu varsayalım. API'nın RESTful olması için mağazanın URL'lerini yazın.
