RESTful API yöntemleri; BAŞLIK VE SEÇENEKLER

PHP'deki bir uygulama için bir RESTful API modülü yazıyorum ve fiillere biraz karıştım HEADve OPTIONS.

• OPTIONS  Belirli bir kaynak için mevcut HTTP fiillerini almak için mi kullanılır?
• HEAD Belirli bir kaynağın mevcut olup olmadığını belirlemek için kullanılır?

Birisi bu fiilleri * netleştirebilseydi, bu çok takdir edilecektir.

_{* Açıklama, HTTP fiillerini yeniden amaçlayan RESTful API mimarileriyle ilgiliydi. O zamandan beri de o gerçekleşme geldiniz HEADve OPTIONSgerektiği değil yeniden amaçlı olabilir ve herhangi bir HTTP uygulaması gerektiği gibi yerine tahmin edilebileceği gibi davranırlar. Oh, 2 yılda nasıl büyüyoruz.}

Göre: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html

9.2 SEÇENEKLER

SEÇENEKLER yöntemi, İstek-URI tarafından tanımlanan istek / yanıt zincirinde bulunan iletişim seçenekleri hakkında bilgi için bir talebi temsil eder. Bu yöntem, istemcinin bir kaynakla ilişkili seçenekleri ve / veya gereksinimleri veya bir sunucunun yeteneklerini, bir kaynak eylemi gerektirmeden veya bir kaynak erişimini başlatmadan belirlemesine izin verir.

Bu yönteme verilen yanıtlar önbelleğe alınamaz.

OPTIONS talebi bir varlık gövdesi içeriyorsa (İçerik Uzunluğu veya Transfer Kodlamasının varlığıyla belirtildiği gibi), ortam türü bir İçerik Türü alanıyla gösterilmelidir ZORUNLU. Bu belirtim böyle bir gövde için herhangi bir kullanım tanımlamasa da, HTTP'nin gelecekteki uzantıları, sunucuda daha ayrıntılı sorgular yapmak için SEÇENEKLER gövdesini kullanabilir. Böyle bir uzantıyı desteklemeyen bir sunucu, istek gövdesini iptal EDEBİLİR.

İstek URI'si bir yıldız işaretiyse ("*"), OPTIONS isteğinin belirli bir kaynak yerine genel olarak sunucuya uygulanması amaçlanır. Bir sunucunun iletişim seçenekleri tipik olarak kaynağa bağlı olduğundan, "*" isteği yalnızca "ping" veya "işlemsiz" yöntem türü olarak kullanışlıdır; istemcinin sunucunun yeteneklerini test etmesine izin vermenin ötesinde hiçbir şey yapmaz. Örneğin, bu, HTTP / 1.1 uyumluluğu (veya eksikliği) için bir proxy'yi test etmek için kullanılabilir.

İstek URI'si bir yıldız işareti değilse, OPTIONS isteği yalnızca bu kaynakla iletişim kurulurken kullanılabilen seçenekler için geçerlidir.

200 yanıtı, sunucu tarafından uygulanan ve bu kaynak için geçerli olan isteğe bağlı özellikleri gösteren (örneğin, İzin Ver), muhtemelen bu belirtimle tanımlanmayan uzantılar da dahil olmak üzere, herhangi bir başlık alanını içermelidir ÖNERİ. Varsa yanıt kuruluşu, iletişim seçenekleri ile ilgili bilgileri de İÇERMELİDİR. Böyle bir gövdenin biçimi bu belirtim tarafından tanımlanmamıştır, ancak HTTP'nin gelecekteki uzantıları tarafından tanımlanabilir. Uygun yanıt biçimini seçmek için içerik pazarlığı KULLANILABİLİR. Yanıt gövdesi dahil edilmemişse, yanıt "0" alan değerine sahip bir İçerik Uzunluğu alanı İÇERMELİDİR.

Max-Forwards istek başlığı alanı, istek zincirindeki belirli bir proxy'yi hedeflemek için KULLANILABİLİR. Bir proxy, istek iletmesine izin verilen bir absoluteURI üzerinde bir OPTIONS talebi aldığında, proxy'nin bir Maks-İletme alanını kontrol etmesi ZORUNLUdur. Max-Forwards alan değeri sıfırsa ("0"), proxy mesajı iletmemelidir * ZORUNLU *; bunun yerine, proxy kendi iletişim seçenekleriyle yanıt vermelidir. Max-Forwards alan değeri sıfırdan büyük bir tamsayı ise, proxy, isteği iletirken alan değerini azaltması ZORUNLUdur. Talepte Max-Forwards alanı yoksa, iletilen istek bir Max-Forwards alanı İÇERMEMELİDİR.

9.4 KAFA

HEAD yöntemi, sunucunun yanıtta bir ileti gövdesi döndürmemesi ZORUNLU olması dışında GET ile aynıdır. Bir HEAD isteğine yanıt olarak HTTP başlıklarında bulunan meta bilgiler, bir GET isteğine yanıt olarak gönderilen bilgilerle aynı olmalıdır. Bu yöntem, kuruluşun kendisini devretmeden, talebin ima ettiği varlık hakkında meta bilgi elde etmek için kullanılabilir. Bu yöntem genellikle geçerlilik, erişilebilirlik ve son değişiklikler için köprü metni bağlantılarını test etmek için kullanılır.

Bir HEAD isteğine verilen yanıt, yanıtta yer alan bilgilerin o kaynaktan önceden önbelleğe alınmış bir varlığı güncellemek için kullanılabilmesi açısından önbelleğe alınabilir. Yeni alan değerleri, önbelleğe alınan varlığın mevcut varlıktan farklı olduğunu gösteriyorsa (Content-Length, Content-MD5, ETag veya Last-Modified'daki bir değişiklikle gösterildiği gibi), o zaman önbellek, önbellek girişini eski olarak ele almalıdır ZORUNLU.

OPTIONSyöntem API hakkında bilgi döndürür (yöntemler / içerik türü)

HEADyöntem, kaynak hakkında bilgi döndürür (sürüm / uzunluk / tür)

Sunucu cevabı

SEÇENEKLER

HTTP/1.1 200 OK
Allow: GET,HEAD,POST,OPTIONS,TRACE
Content-Type: text/html; charset=UTF-8
Date: Wed, 08 May 2013 10:24:43 GMT
Content-Length: 0

KAFA

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Type: text/html; charset=UTF-8
Date: Wed, 08 May 2013 10:12:29 GMT
ETag: "780602-4f6-4db31b2978ec0"
Last-Modified: Thu, 25 Apr 2013 16:13:23 GMT
Content-Length: 1270

• OPTIONS Bir kaynağın hangi HTTP yöntemlerini desteklediğini belirleme, örneğin onu SİLİNEBİLİR MİYİZ veya bir PUT yoluyla güncelleyebilir miyiz?
• HEADBir kaynağın değişip değişmediğini kontrol etme. Bu, bir kaynağın önbelleğe alınmış bir sürümünü korurken kullanışlıdır
• HEAD Muhtemelen maliyetli bir geri alma işlemi yapmadan önce, kaynakla ilgili meta verileri, örneğin ortam türü veya boyutu gibi geri alma
• HEAD, OPTIONSBir kaynağın var olup olmadığını ve erişilebilir olup olmadığını test etme. Örneğin, bir uygulamada kullanıcı tarafından gönderilen bağlantıların doğrulanması

HEAD ve OPTIONS'ın RESTful mimarisine nasıl uyduğuna dair güzel ve özlü bir makale burada .

SEÇENEKLER size "Bu kaynak için hangi yöntemlere izin verilir" gibi şeyler söyler.

HEAD, gövde olmadan bir GET isteğinde bulunmanız durumunda alacağınız HTTP başlığını alır. Bu, istemcinin önbelleğe alma bilgilerini, hangi içerik türünün döndürüleceğini, hangi durum kodunun döndürüleceğini belirlemesini sağlar. Kullanılabilirlik bunun sadece küçük bir kısmı.