REST , web'in altında yatan mimari ilkedir. Web ile ilgili şaşırtıcı olan şey, istemcilerin (tarayıcılar) ve sunucuların, istemci, sunucu ve barındırdığı kaynaklar hakkında önceden bir şey bilmeden karmaşık şekillerde etkileşime girebilmesidir. Temel kısıtlama, sunucunun ve istemcinin , web'de HTML olan medya üzerinde hemfikir olması gerektiğidir .
REST prensiplerine uyan bir API , müşterinin API'nin yapısı hakkında hiçbir şey bilmesini gerektirmez. Bunun yerine, sunucunun istemcinin hizmetle etkileşime girmesi için gereken bilgileri sağlaması gerekir. Bir HTML formu bu bir örnektir: Sunucu kaynak ve gerekli alanları konumunu belirtir. Tarayıcı, bilgilerin nereye gönderileceğini önceden bilmiyor ve hangi bilgilerin gönderileceğini önceden bilmiyor. Her iki bilgi formu da tamamen sunucu tarafından sağlanır. (Bu ilke HATEOAS olarak adlandırılır : Uygulama Durumunun Motoru Olarak Hiper Ortam .)
Peki, bu HTTP için nasıl geçerlidir ve pratikte nasıl uygulanabilir? HTTP fiillere ve kaynaklara yöneliktir. Ana akım kullanımdaki iki fiil GETve POSTbence herkes tanıyacak. Ancak, HTTP standardı PUTve gibi birkaç tanesini tanımlar DELETE. Bu fiiller daha sonra sunucu tarafından sağlanan talimatlara göre kaynaklara uygulanır.
Örneğin, bir web hizmeti tarafından yönetilen bir kullanıcı veritabanımız olduğunu düşünelim. Hizmetimiz, mime türünü atadığımız JSON'a dayalı özel bir hiper ortam kullanır application/json+userdb(Ayrıca application/xml+userdbve application/whatever+userdbbirçok medya türü desteklenebilir). İstemci ve sunucu bu biçimi anlayacak şekilde programlanmıştır, ancak birbirleri hakkında hiçbir şey bilmemektedirler. Roy Fielding'in belirttiği gibi :
Bir REST API, neredeyse tüm tanımlayıcı çabalarını kaynakları temsil etmek ve uygulama durumunu göstermek için kullanılan ortam türlerini tanımlamak veya mevcut standart ortam türleri için genişletilmiş ilişki adlarını ve / veya hipermetin özellikli işaretlemeyi tanımlamak için harcamalıdır.
Temel kaynak talebi şu şekilde /olabilir:
İstek
GET /
Accept: application/json+userdb
Tepki
200 OK
Content-Type: application/json+userdb
{
"version": "1.0",
"links": [
{
"href": "/user",
"rel": "list",
"method": "GET"
},
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
Medyamızın açıklamasından "bağlantılar" adı verilen bölümlerden ilgili kaynaklar hakkında bilgi bulabileceğimizi biliyoruz. Buna Hipermedya kontrolleri denir . Bu durumda, böyle bir bölümden, başka bir istekte bulunarak bir kullanıcı listesi bulabileceğimizi söyleyebiliriz./user :
İstek
GET /user
Accept: application/json+userdb
Tepki
200 OK
Content-Type: application/json+userdb
{
"users": [
{
"id": 1,
"name": "Emil",
"country: "Sweden",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
{
"id": 2,
"name": "Adam",
"country: "Scotland",
"links": [
{
"href": "/user/2",
"rel": "self",
"method": "GET"
},
{
"href": "/user/2",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/2",
"rel": "delete",
"method": "DELETE"
}
]
}
],
"links": [
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
Bu yanıttan çok şey söyleyebiliriz. Örneğin, şimdi yeni bir kullanıcı oluşturmak biliyorum POSTiçin ing /user:
İstek
POST /user
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Karl",
"country": "Austria"
}
Tepki
201 Created
Content-Type: application/json+userdb
{
"user": {
"id": 3,
"name": "Karl",
"country": "Austria",
"links": [
{
"href": "/user/3",
"rel": "self",
"method": "GET"
},
{
"href": "/user/3",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/3",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
Ayrıca mevcut verileri değiştirebileceğimizi de biliyoruz:
İstek
PUT /user/1
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Emil",
"country": "Bhutan"
}
Tepki
200 OK
Content-Type: application/json+userdb
{
"user": {
"id": 1,
"name": "Emil",
"country": "Bhutan",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
Farklı HTTP fiilleri kullandığınızı Bildirimi ( GET, PUT, POST, DELETEvb) bu kaynakları işlemek ve biz müşterinin kısmında tahmin sadece bilgi bizim medya tanımı olduğunu için.
Daha fazla okuma:
(Bu cevap, noktayı kaçırmak için adil bir eleştiri konusu olmuştur. Çoğunlukla, bu adil bir eleştiri olmuştur. Başlangıçta tarif ettiğim şey, REST'in birkaç yıl önce genellikle nasıl uygulandığımla daha uyumlu idi. ilk önce, gerçek anlamından ziyade bunu yazdı. Cevabı, gerçek anlamı daha iyi temsil etmek için revize ettim.)
