Adres doğru ama metot yanlışsa ne olur?
Bir günlük özet kaynağı GET ile okunabiliyor, ancak POST ile değiştirilemiyor olabilir. 405 Method Not Allowed, sunucunun metodu tanıdığını fakat hedef kaynağın o metodu desteklemediğini belirtir. Yanıtta hedefin şu anda desteklediği metotları bildiren Allow başlığı bulunmalıdır. MDN 405 referansı bu davranışı tanımlar.
Bu yazı kurgusal /api/daily-summary kaynağını kullanır. Amacımız kayıt sayısını güncellemek değil, aynı adresin farklı metotlara nasıl yanıt verdiğini incelemek. Gösterilen mesajlarda genel sunucu ve çerçeveleme başlıkları kısaltılmıştır.
Çalışan okuma isteğini önce görün
GET /api/daily-summary HTTP/1.1
Host: example.test
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{"events":4}
Bu sözleşmede GET özet döndürür, HEAD aynı okuma kaynağının başlıklarını gövdesiz verir, OPTIONS ise desteklenen metotları açıklar. Kaynağı POST ile değiştirme eylemi tanımlanmadı. HEAD gövdesinin neden boş olduğunu HEAD ve GET yazısında ayrıntılı inceleyebilirsiniz.
405 yanıtında desteklenen metotları bildirin
POST /api/daily-summary HTTP/1.1
Host: example.test
Content-Type: application/json
{"events":9}
HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD, OPTIONS
Content-Type: application/problem+json
Cache-Control: no-store
{"type":"about:blank","title":"Method Not Allowed","status":405}
Allow, istekle gönderdiğiniz “izin isteği” değildir; sunucunun yanıt başlığıdır. Metot adlarını virgülle ayırır. Liste o kaynağın mevcut desteğini anlatır, bütün sunucunun metot kataloğunu değil. Allow belgesi geçici olarak hiç metot desteklenmeyen bir kaynak için boş değerin de mümkün olduğunu açıklar.
Gövdenin JSON olması tek başına yeterli değildir; istemcinin tutarlı bir hata biçimi beklemesi de gerekir. Burada about:blank türüyle HTTP durumunu anlatan küçük bir problem nesnesi seçtik. Problem Details rehberi daha ayrıntılı alanları ele alır.
OPTIONS ile CORS ön kontrolünü aynı şey saymayın
Bu örnekte sıradan bir OPTIONS isteği de desteklenen metotları döndürür:
OPTIONS /api/daily-summary HTTP/1.1
Host: example.test
HTTP/1.1 204 No Content
Allow: GET, HEAD, OPTIONS
Cache-Control: no-store
204 yanıtının gövdesi yoktur. Bu mesajda Origin veya Access-Control-Request-Method gönderilmedi; örnek bir CORS ön kontrol akışı göstermiyor. Her 405 sonucundan önce tarayıcının OPTIONS göndermesi gerektiği gibi bir kural da yoktur.
Access-Control-Allow-Methods, tarayıcının CORS ön kontrolünde kullandığı ayrı bir yanıt başlığıdır. Allow yerine geçmez ve bir metoda sunucu tarafında işleyici eklemez. CORS izni verilmiş bir metot, hedefte uygulama olarak desteklenmiyorsa istek yine başarısız olabilir. CORS rehberi ön kontrolün hangi katmanda çalıştığını açıklar; MDN başlık belgesi ilgili alanı tanımlar.
İstemci yanlış metodu otomatik değiştirmesin
Aşağıdaki yardımcı bu örnek özet kaynağını aynı origin'den okur. Yanlışlıkla 405 alırsa Allow bilgisini hata metnine ekler; listedeki başka bir metodu seçip yeniden istek yapmaz.
async function readSummary() {
const response = await fetch('/api/daily-summary', {
method: 'GET',
headers: { Accept: 'application/json' },
});
if (response.status === 405) {
const allowed = response.headers.get('Allow');
throw new Error('GET is unavailable; Allow: ' + (allowed ?? 'not available'));
}
if (response.status !== 200) throw new Error('Expected a summary response');
const data = await response.json();
if (!Number.isSafeInteger(data?.events) || data.events < 0) {
throw new TypeError('Invalid event count');
}
return data;
}
Başka bir origin'deki yanıttan Allow okumak, CORS politikasında Access-Control-Expose-Headers ile bu başlığın JavaScript'e açılmasını gerektirebilir. Bu yardımcı aynı origin varsayar. Gösterilen hata metni kullanıcı arayüzüne olduğu gibi basılmak zorunda değildir; uygulamanız anlamlı bir işlem mesajı seçebilir.
405'i aynı POST'u bekleyip yeniden göndererek çözmeye çalışmayın. Metot ve hedef adresin API sözleşmesiyle uyumunu, yönlendirme olup olmadığını ve sunucudaki rota eşlemesini kontrol edin. Retry rehberi, geçici hata ile sözleşme hatasına farklı yaklaşmanın nedenini açıklar.
Sık sorulan sorular
405 ile 404 aynı mı? Hayır. Bu örnekte kaynak var ve GET çalışıyor; sorun POST desteğinin olmaması. Bilinmeyen adres, ayrı bir kaynak eşlemesi durumudur.
405 ile 501 farkı nedir? 405 hedef kaynakla ilgilidir. Sunucu bir metodu tanımıyor ve hiçbir kaynak için destekleyemiyorsa 501 uygun olabilir. RFC 9110 bu ayrımı tanımlar.
Allow listesi kullanıcıya işlem yetkisi verir mi? Hayır. Metot desteği, kimlik doğrulama ve işleme yetkisi ayrı kontrollerdir; 401 ve 403 rehberi bu katmanı inceler.

