Status Kodu 308 Kalıcı Yönlendirme Nedir? Kırılmaz Yönlendirme

API'nizi yeniden düzenliyorsunuz. POST /api/v1/create-user uç noktasının adının kötü olduğuna karar verdiniz ve bunu daha doğru olan POST /api/v1/users olarak değiştirmeniz gerekiyor. Bu kalıcı, yapısal bir değişiklik. Bir yönlendirmeye ihtiyacınız olduğunu biliyorsunuz, ancak kritik bir gereksiniminiz var: eski uç noktaya veri POST eden herhangi bir uygulamanın verileri kusursuz bir şekilde korunmalı ve yeni olana iletilmelidir.

Bu, özel bir araç gerektiren bir iştir. Belirsiz olabilen tanıdık 301 Moved Permanently için bir iş değildir. **308 Permanent Redirect** durum kodunun hassasiyetini ve gücünü gerektirir.

308, HTTP yönlendirme ailesindeki nihai garantidir. Sunucudan gelen kalıcı, yöntem koruyucu, gövde koruyucu, saçmalık içermeyen bir komuttur. Der ki, "Sonsuza dek taşındım. Eski adresime basit bir GET veya verilerle karmaşık bir POST olsun, herhangi bir istek gönderdiğinizde, *tamamen aynı* isteği yeni adresime yeniden göndermenizi rica ediyorum."

Peki, **durum kodu 308** aslında ne anlama geliyor? 301 veya 307'den farkı ne? Ve gerçek dünya senaryolarında ne zaman kullanmalısınız?

GET dışındaki istekleri işleyen API'ler geliştiriyorsanız, 308'i anlamak, geriye dönük uyumluluğu sürdürmek ve geçişler sırasında veri bütünlüğünü sağlamak için çok önemlidir.

Ve teknik detaylara dalmadan önce, gelişen API uç noktalarını yönetiyorsanız, bu kritik, yönteme duyarlı yönlendirmeleri test edebilecek bir araca ihtiyacınız var. Bu kapsamlı blog yazısında, **308 Permanent Redirect** durum kodu hakkında ne anlama geldiğinden nasıl çalıştığına, ne zaman ve neden kullanmanız gerektiğine kadar bilmeniz gereken her şeyi keşfedeceğiz. Ayrıca, karmaşık HTTP yanıtlarını etkili bir şekilde test etmenize ve belgelemenize yardımcı olmak için, iş akışınızı basitleştirmek ve 308 gibi HTTP durum kodları hakkında derinlemesine bilgi sağlamak üzere tasarlanmış kullanıcı dostu bir API test ve belgeleme aracı olan **Apidog'u ücretsiz indirmeyi** unutmayın.

button

Şimdi, **HTTP durum kodu 308 Permanent Redirect**'in ardındaki detayları çözelim.

Sorun: 301 Moved Permanently Belirsizliği

308'in neden oluşturulduğunu anlamak için önce selefi olan 301 Moved Permanently'ye bakmalıyız.

301 yönlendirmesi, çoğu yaygın web tarama senaryosu için harikadır. Ancak, orijinal spesifikasyonu, 302/307 durumuna benzer şekilde kritik bir belirsizliğe sahipti. Spesifikasyon, yönlendirme sırasında orijinal isteğin HTTP yöntemi ve gövdesine ne olması gerektiğini açıkça belirtmiyordu.

Uygulamada, birçok kullanıcı aracısı (özellikle web tarayıcıları), bir 301 yönlendirmesini takip ederken bir POST isteğini bir GET isteğine dönüştürürdü. İstek gövdesi düşerdi.

API Geliştiricisinin Kabus Senaryosu:

Bir mobil uygulama eski uç noktanıza JSON verisi POST eder: POST /old-api {"name": "John"}
Sunucunuz şu şekilde yanıt verir: 301 Moved Permanently + Location: /new-api
Mobil uygulamanın HTTP kütüphanesi, yönlendirmeyi GET /new-api (gövdesiz) göndererek takip eder.
JSON ile bir POST bekleyen /new-api uç noktanız, bir GET alır ve 405 Method Not Allowed hatası döndürür.
Mobil uygulama tüm kullanıcıları için bozulur.

308 durum kodu, bu sorunu mutlak hassasiyetle çözmek için tanıtıldı.

HTTP 308 Permanent Redirect Gerçekten Ne Anlama Geliyor?

308 Permanent Redirect durum kodu, hedef kaynağa yeni bir kalıcı URI atandığını gösterir. Temel fark, kullanıcı aracısının yönlendirilen isteği yaparken orijinal istekte kullanılan istek yöntemini **DEĞİŞTİRMEMESİ** gerektiğidir.

Ayrıca, orijinal isteğin gövdesi korunmalı ve yeniden gönderilmelidir.

Basitçe söylemek gerekirse: **"Kaynak sonsuza dek taşındı. Aynı isteği bu yeni konuma yeniden gönderin."**

Tipik bir 308 yanıtı şöyle görünür:

HTTP/1.1 308 Permanent RedirectLocation: <https://new-api.example.com/v2/usersContent-Type:> text/htmlContent-Length: 147
<html><head><title>308 Permanent Redirect</title></head><body><center><h1>308 Permanent Redirect</h1></center></body></html>

Kritik unsurlar, durum kodunun kendisi (308) ve **Location** başlığıdır. HTML gövdesi genellikle otomatik istemciler tarafından göz ardı edilir.

HTTP'de Yönlendirmeler Neden Önemlidir?

Yönlendirmeler, web'in temel bir parçasıdır. Sunucuların, istemcileri bozmadan kaynak konumundaki değişiklikleri iletmesini sağlarlar.

Bazı yaygın kullanım durumları şunları içerir:

**HTTP'den HTTPS'ye** geçiş.
Mevcut istemcileri bozmadan **API uç noktalarını** güncelleme.
Yeniden tasarım sırasında bir web sitesinin URL yapısını değiştirme.
**İçerik sürümleme** veya yeniden düzenleme işlemlerini yönetme.

Yönlendirmeler olmasaydı, geliştiriciler sürekli olarak **404 Bulunamadı hataları** ve bozuk kullanıcı deneyimleriyle karşılaşırdı.

308 Permanent Redirect Neden Tanıtıldı?

Daha eski 301 durum kodu, istemcilere URL'leri kalıcı olarak güncellemelerini söyler. Ancak, tarayıcılar tarihsel olarak 301 yönlendirmelerini takip ederken POST gibi HTTP yöntemlerini GET'e dönüştürerek form verilerinin kaybolması veya beklenmeyen yanıtlar gibi istenmeyen davranışlara neden oluyordu.

Bu sınırlamaları gidermek için, RFC 7538 spesifikasyonu, kullanıcı aracılarının açıkça garanti altına alınması için **308 Permanent Redirect**'i tanıttı:

Yönlendirme sonrası HTTP yöntemlerini korumalıdır
POST'u GET'e (veya başka bir yöntem değişikliğine) dönüştürmemelidir

Bu, 308'i özellikle yönlendirme yolu boyunca yöntem tutarlılığı gerektiren API'lerde ve web uygulamalarında kullanışlı kılar.

308 ve 301: Kritik Karşılaştırma

Bu, API geliştiricileri için en önemli ayrımdır.

Özellik	`301 Kalıcı Olarak Taşındı`	`308 Kalıcı Yönlendirme`
Yöntem Koruma	Garanti edilmez. Tarayıcılar genellikle POST'u GET'e dönüştürür.	Garanti edilir. Yöntem aynı olmalıdır (POST, POST olarak kalır).
Gövde Koruma	Garanti edilmez. İstek gövdesi tipik olarak düşer.	Garanti edilir. Orijinal istek gövdesi yeniden gönderilir.
Kullanım Durumu	Web sayfası URL'lerinin kalıcı yönlendirmeleri için mükemmeldir (burada orijinal istek neredeyse her zaman GET'tir).	POST, PUT, DELETE'i işleyen API uç noktalarının kalıcı yönlendirmeleri için çok önemlidir.
Güvenlik	GET dışındaki yöntemler için potansiyel olarak güvensizdir.	Tüm HTTP yöntemleri için güvenlidir.
Benzetme	"O dükkanın yeni kalıcı bir adresi var. Git bir bak." (Eli boş gidersiniz).	"Tüm fabrika taşındı. Gelecekteki tüm gönderileri, tam olarak paketlendiği gibi, bu yeni depo adresine gönderin."

Hangisini ne zaman kullanmalı?

**301 Moved Permanently kullanın**; **web sayfası bağlantılarını** kalıcı olarak yönlendirirken (örn. bir blog yazısının URL'sini değiştirirken). SEO dostudur ve GET istekleri için mükemmel çalışır.
**308 Permanent Redirect kullanın**; veri alan (POST, PUT) veya diğer GET dışı yöntemleri kullanan **API uç noktalarını** kalıcı olarak yönlendirirken. Veri bütünlüğünü garanti eder.

308 Permanent Redirect Nasıl Çalışır?

İşte tipik bir 308 yönlendirme akışı:

İstemci bir istek yapar:

POST /checkout HTTP/1.1
Host: shop.example.com

2. Sunucu 308 ile yanıt verir:

HTTP/1.1 308 Permanent Redirect
Location: <https://secure.example.com/checkout>

3. İstemci, gövdeyi ve başlıkları koruyarak yeni konumda POST isteğini tekrarlar:

POST /checkout HTTP/1.1
Host: secure.example.com

Yöntem değişikliği yok. Sürpriz yok. Yönlendirme kalıcı olduğundan, istemcilerin yer imlerini ve dahili referansları buna göre güncellemesi beklenir.

308 Permanent Redirect Kullanım Durumları

308 yönlendirmeleri, aşağıdaki senaryolarda en iyi şekilde uyar:

Kalıcı bir URL yeniden yapılandırması yaparsınız ancak istemcilerin orijinal HTTP yöntemlerini kullanmaya devam etmesini istersiniz.
API'nizin veya web uygulamanızın URL'leri değişmiş POST, PUT veya DELETE uç noktaları vardır.
Form gönderimlerini bozmadan SEO dostu kalıcı yönlendirmeler uygulamak istersiniz.
Eski yönlendirme kodlarının neden olduğu yanlışlıkla yöntem değişikliğini önlemek için güvenilir bir yola ihtiyacınız var.

Gerçek Bir Örnek: API Geçişi

API'nizi sürümlendirdiğinizi ve eski bir uç noktayı kullanımdan kaldırmanız gerektiğini hayal edin.

Eski Sistem:

Uç Nokta: POST /v1/orders
Gövde: { "product_id": "abc123", "quantity": 2 }

Yeni Sistem:

Uç Nokta: POST /v2/orders
Gövde: { "product_id": "abc123", "quantity": 2 } (Aynı yapı)

v1 sunucusunu kapatmak istiyorsunuz ancak henüz güncellemeyen eski istemcileri bozmak istemiyorsunuz. Çözümünüz, v1 sunucusunda bir 308 yönlendirmesidir:

1. Eski İstemcinin İsteği: Eski bir uygulama, eski uç noktaya bir istek gönderir.

POST /v1/orders HTTP/1.1Host: api.example.comContent-Type: application/json
{"product_id": "abc123", "quantity": 2}

2. 308 Yanıtı: v1 sunucusu, v2 uç noktasına bir yönlendirme ile yanıt verir.

HTTP/1.1 308 Permanent RedirectLocation: <https://api.example.com/v2/orders>

3. Korunan İstek: İstemcinin HTTP kütüphanesi 308 spesifikasyonuna uyar. **Tamamen aynı POST isteğini, tamamen aynı JSON gövdesiyle** yeni konuma yeniden gönderir.

POST /v2/orders HTTP/1.1Host: api.example.comContent-Type: application/json
{"product_id": "abc123", "quantity": 2} # The original body is preserved!

4. Başarılı Sipariş: v2 sunucusu isteği işler ve siparişi oluşturur, 201 Created yanıtı döndürür. Eski istemci, herhangi bir kod değişikliği olmadan mükemmel şekilde çalışır.

Bu yaklaşım, API tüketicileri için sorunsuz ve sağlam bir geçiş yolu sağlar.

Örnek: URL Değişikliğinden Sonra 308 Yönlendirmesi Uygulama

Bir kaynağın URI'sinin değiştiği bir REST API hayal edin:

İstemci, **http://api.example.com/v1/resource** adresine bir POST isteği gönderir.
Sunucu yanıt verir:

textHTTP/1.1 308 Permanent Redirect Location: <https://api.example.com/v2/resource>

3. Tarayıcı veya istemci, POST isteğini değişmeden **https://api.example.com/v2/resource** adresine yeniden gönderir.

4. API, isteği amaçlandığı gibi işler.

Bu, istek semantiğini korur ve sorunsuz geçişi sağlar.

308 Permanent Redirect'in Faydaları

**Tutarlılık** → Yöntem korumasını garanti eder.
**Netlik** → İstemcilere ve arama motorlarına kalıcı bir değişikliği açıkça bildirir.
**Güvenlik** → POST'un yanlışlıkla GET'e düşürülmesini önler.
**Geleceğe Hazırlık** → Modern HTTP/2+ ortamlarında iyi çalışır.

308 Yönlendirmeleri Nasıl Uygulanır?

Uygulama, sunucunuza veya platformunuza bağlıdır.

Apache (.htaccess veya yapılandırma)

textRedirectPermanent 308 /old-path <https://example.com/new-path>

Nginx

textlocation /old-path { return 308 <https://example.com/new-path>; }

Express.js (Node.js)

javascriptapp.post('/old-path', (req, res) => { res.redirect(308, '<https://example.com/new-path>'); });

İstemciler 308 Yönlendirmelerini Nasıl İşler?

308 nispeten yeni bir kod olduğundan, istemci desteği değişmekle birlikte modern tarayıcılarda ve HTTP kütüphanelerinde yaygın olarak benimsenmiştir:

Çoğu tarayıcı, 308 yönlendirmelerinden sonra HTTP yöntemlerini korur.
Eski istemciler kalıcı yönlendirmelerde varsayılan olarak GET'e dönebilir – test çok önemlidir.
İstemciler, 308 aldıktan sonra yer imlerindeki ve önbelleklerindeki URL'leri güncellemelidir.

API Geliştirme ve Mikroservislerde 308

API'ler ve mikroservisler için 308, oyunun kurallarını değiştiren bir özelliktir.

Şunu hayal edin:

Bir API'yi api.v1.example.com'dan api.v2.example.com'a taşıyorsunuz.
Bazı istemciler hala kritik yüklerle **POST istekleri** gönderiyor.
301 ile, bu POST'lar GET'lere dönüşebilir ve her şeyi bozabilir.
308 ile, istemciler POST'u amaçlandığı gibi güvenle yeniden gönderir.

Bu, 308'i **kritik API trafiği** için paha biçilmez kılar.

Apidog ile 308 Yönlendirmelerini Test Etme

Bu davranışı test etmek, bir üretim API'si için tartışılmazdır. Yönlendirmelerinizin doğru çalıştığından ve istemcilerin beklendiği gibi davranacağından emin olmalısınız. Bunun için **Apidog** vazgeçilmez bir araçtır.

Apidog ile şunları yapabilirsiniz:

1. Bir POST İsteği Oluşturun: Eski uç nokta URL'nize belirli bir JSON veya XML gövdesiyle bir istek oluşturun.

2. 308 Yanıtını Taklit Edin: Sunucu taklidinizi, yeni Location başlığıyla bir 308 durumu döndürecek şekilde yapılandırın.

3. Yönlendirilen İsteği Doğrulayın: En kritik adım. İsteği gönderdikten sonra, otomatik olarak gönderilen *ikinci* isteği incelemek için Apidog'un ayrıntılı günlüklerini kullanın.

Location başlığındaki doğru URL'ye gitti mi?
**HTTP yöntemi hala POST muydu?**
**İstek gövdesi orijinaliyle aynı mıydı?**

4. 301 ile Karşılaştırın: Aynı testi çalıştırın ancak taklidin 301 döndürmesini sağlayın. Apidog'un (standart bir istemci olarak hareket ederek) yöntemi muhtemelen GET'e nasıl değiştirdiğini ve gövdeyi nasıl düşürdüğünü gözlemleyin. Bu yan yana karşılaştırma, pratik farkı anlamanın en iyi yoludur.

5. İstemci Kütüphanelerini Test Edin: Bir SDK veya istemci geliştiriyorsanız, sunucuyu taklit etmek için Apidog'u kullanın ve istemci kodunuzun yöntemi ve gövdeyi koruyarak bir 308 yanıtını doğru şekilde işlediğinden emin olun.

button

Yönlendirme testini zahmetsiz ve güvenilir hale getirmek için Apidog'u ücretsiz indirin ve bir 308 yönlendirmesini kendiniz taklit etmeyi deneyin – kurulumu dakikalar sürer.

SEO Etkileri

301'in aksine, 308 kodu öncelikle web sayfaları için değil, API'ler içindir. Google gibi arama motorlarının çoğu web tarayıcısı öncelikli olarak GET istekleri yapar. Onlar için, bir 301 ve bir 308 aynı etkiye sahip olacaktır: dizinlerini yeni URL'ye güncelleyecek ve sıralama sinyallerini aktaracaklardır.

Ancak, web sitenizdeki kalıcı sayfa taşımaları için hala 301 kullanmalısınız. HTML içeriği için evrensel olarak desteklenen ve beklenen standarttır ve davranışı tüm web tarayıcıları ve tarayıcılar tarafından iyi anlaşılmıştır. Sisteminizin programatik, veri odaklı kısımları için 308 kullanın.

Kaçınılması Gereken Yaygın Tuzaklar

**Geçici** bir yönlendirme gerektiğinde 308 kullanmak (bunun yerine 307 kullanın).
Yönlendirmede yöntemleri yanlış dönüştürmek için sunucuları yanlış yapılandırmak.
Tüm istemcilerin 308'i desteklediğini varsaymak – kullanıcı tabanınızda sağlam bir şekilde test edin.
Kalıcı URL değişikliklerini yansıtmak için dahili bağlantıları güncellemeyi unutmak.

308 Ne Zaman Kullanılmaz?

Geçici yönlendirmeler için **307 Temporary Redirect** kullanın.
Yönlendirme sonrası istemcinin GET yöntemine geçmesini istediğinizde **303 See Other** kullanın.
URL değişikliği olmadığında, yönlendirme kodlarından tamamen kaçının.

308 Permanent Redirect Alternatifleri

İhtiyaçlarınıza bağlı olarak:

POST/PUT'un dahil olmadığı basit kalıcı yönlendirmeler için **301** kullanın.
Geçici yöntem koruyucu yönlendirmeler için **307 Temporary Redirect** kullanın.
SEO'yu etkilemeyen hızlı, geçici yönlendirmeler için **302 Found** kullanın.

Kalıcı + yöntem koruyucu davranış istediğinizde 308 en uygunudur.

308 Yönlendirmeleri İçin Güvenlik Hususları

Yönlendirmeler dikkatli kullanılmazsa kötüye kullanılabilir. 308 ile:

Location başlığında her zaman **HTTPS** kullanın.
Güvenilmeyen alan adlarına yönlendirmekten kaçının.
**Açık yönlendirme güvenlik açıklarını** test edin.

308, hassas yöntemleri korumak için 301'den daha güvenlidir, ancak yine de güvenli bir şekilde yapılandırmak önemlidir.

Sonuç: API Gelişimi İçin Hassas Araç

HTTP 308 Permanent Redirect durum kodu, belirli, kritik bir iş için tasarlanmış uzman bir araçtır: kalıcı API geçişleri sırasında GET dışı isteklerin bütünlüğünü sağlamak. HTTP protokolünün daha fazla hassasiyet ve güvenilirliğe doğru evrimini temsil eder ve seleflerinin tehlikeli belirsizliklerini ortadan kaldırır.

HTTP durum kodu 308 Permanent Redirect, HTTP yöntemlerini korurken kalıcı URL değişikliklerini yönetmek için modern, hassas bir yol sunar ve bu da onu yöntem tutarlılığına dayanan API'ler ve web uygulamaları için paha biçilmez kılar.

Web siteniz için her gün 301 yönlendirmeleri kullanıyor olsanız da, 308, riskler daha yüksek olduğunda, verilerin kaybolmadığını, API istemcilerinin bozulmadığını ve arka uç gelişiminizin sorunsuz bir şekilde gerçekleştiğini garanti etmeniz gerektiğinde başvurduğunuz araçtır.

308'i doğru kullanarak, kullanıcı deneyimini iyileştirebilir, isteklerin bütünlüğünü koruyabilir ve SEO yatırımınızı koruyabilirsiniz.

Bu ayrımı anlamak, web temellerini anlayan bir geliştirici ile sağlam, profesyonel sistemler tasarlayan bir geliştirici arasındaki temel bir farktır. Ve bu kritik yönlendirmeleri uygulamak ve test etmek, özellikle yönlendirmeleri içeren API uç noktalarınızı test etmek ve belgelemek zamanı geldiğinde, **Apidog'u ücretsiz indirmeyi** unutmayın. Apidog, 308 gibi HTTP durum kodlarını kapsamlı bir şekilde keşfetmenizi sağlayarak, güvenle ve netlikle geliştirmenize yardımcı olur.

button