URL Yönlendirmeleri
Mağazanın eski bir adresine (/eski-urun) gelen ziyaretçiyi kalıcı (301) yönlendirmeyle yeni adrese (/yeni-urun) gönderir. Başka bir platformdan taşınan mağazanın eski adreslerini korumak ve arama motoru sıralamasını kaybetmemek için kullanın.
read_redirects, ekleme/güncelleme/silme write_redirects. Bu kapsamlar yalnız 301 yönlendirmelerini açar; ürün, kategori ve sayfaların kendi adreslerini ve SEO alanlarını görmez, değiştiremez.Uç: config/redirect-links. Kaynağın type değeri redirect-links'tir.
Nasıl çalışır
- Yönlendirme yalnız kimsenin kullanmadığı bir adreste çalışır. Ürün, kategori ya da sayfanın kendi adresine yönlendirme yazamazsınız (
422); canlı sayfa hiçbir zaman ezilmez. - Adres mağazada tekildir; büyük/küçük harf ve sondaki
/fark etmez (Eski-Urun/ileeski-urunaynı adrestir). - Vitrin adresi sorgu parametreleriyle birlikte birebir arar, bulamazsa parametreleri atıp yeniden arar.
eski?renk=maviveeski?beden=m&renk=maviayrı adreslerdir; parametre sırası normalize edilmez.
Yönlendirme ekleme
curl -X POST 'https://magaza.com/api/v3/admin/2026-01/config/redirect-links' \
-H 'Authorization: Bearer <access_token>' \
-H 'Accept: application/vnd.api+json' \
-H 'Content-Type: application/vnd.api+json' \
-d '{
"data": {
"type": "redirect-links",
"attributes": {
"seoLink": "eski-urun",
"redirectLink": "yeni-urun"
}
}
}'
| Alan | Zorunlu | Açıklama |
|---|---|---|
seoLink | Evet | Yönlendirilecek eski adres, mağaza içinde bir yol (ör. eski-urun, kategori/eski). En fazla 250 karakter |
redirectLink | Hayır | Hedef yol (ör. yeni-urun). Boş bırakılırsa ana sayfaya yönlenir. En fazla 250 karakter |
language | Hayır | Dil kodu; verilmezse isteğin dili |
linkType | Hayır | Yalnız 301 |
Yanıtta appPrefix alanı kaydı yazan uygulamayı gösterir (ör. app.ornek); mağazanın ya da sistemin yazdığı yönlendirmede null'dır.
Kurallar
| Durum | Sonuç |
|---|---|
Baştaki ya da sondaki / (/eski/) | Atılır, eski olarak kaydedilir |
Hedefte mağazanın kendi alan adı (https://magaza.com/yeni) | Göreli yola çevrilir: yeni |
Hedef başka bir alan adı ya da // ile başlıyor | 422. Uygulamalar yalnız mağazanın kendi adreslerine yönlendirebilir |
Boş yol, tam adres ya da ? ile başlayan yol | 422 |
| Hedef yönlendirmenin kendi adresi (döngü) | 422 |
| Hedef zaten başka bir yere yönleniyor (zincir) | 422. Doğrudan son hedefi yazın; yönlendirme en fazla tek adımdır |
| Adres bir ürüne, kategoriye ya da sayfaya ait | 422 |
| Adreste zaten yönlendirme var | 422 |
Toplu ekleme
Tek istekte en fazla 1.000 yönlendirme. Her satır ayrı doğrulanır; geçerli satırlar kaydedilir, hatalı satırlar ötekileri durdurmaz.
curl -X POST 'https://magaza.com/api/v3/admin/2026-01/config/redirect-links/-actions/batch' \
-H 'Authorization: Bearer <access_token>' \
-H 'Accept: application/vnd.api+json' \
-H 'Content-Type: application/vnd.api+json' \
-d '{
"redirects": [
{ "seoLink": "eski-urun-1", "redirectLink": "yeni-urun-1" },
{ "seoLink": "eski-urun-1", "redirectLink": "yeni-urun-2" }
]
}'
{
"meta": {
"created": 1,
"failed": 1,
"results": [
{ "index": 0, "status": "created", "id": "4812" },
{
"index": 1,
"status": "failed",
"errors": [
{ "source": { "pointer": "/redirects/1/seoLink" }, "detail": "Link zaten mevcut." }
]
}
]
}
}
Satırlar sırayla yazılır: aynı istekte bir satırın adresi önceki satırınkiyle aynıysa ikincisi failed döner. Satır sayısı 1.000'i aşarsa ya da uygulamaların kalan kapasitesini aşarsa istek bütünüyle 422 döner, hiçbir satır yazılmaz. Uç dakikada 20 istekle sınırlıdır.
Listeleme, güncelleme, silme
GET /config/redirect-links: uygulamanız yalnız 301 yönlendirmelerini görür, mağazanın ve başka uygulamaların yazdıkları dahil. Filtreler:filter[seoLink],filter[appPrefix]=app.ornek(bir uygulamanın yazdıkları),filter[storeOwned]=true(uygulamaların yazmadıkları),filter[language].PATCH /config/redirect-links/{id}: hedefi ya da adresi değiştirir; aynı kurallar geçerlidir. Yalnız hedefi değişmeyen alanları güncellerseniz eski kayıtlar kural dışı olsa bile düzenlenebilir.DELETE /config/redirect-links/{id}: yönlendirmeyi siler.- Ürün, kategori ya da sayfa adresinin kimliğini verirseniz
404alırsınız.
Sınırlar
| Sınır | Değer |
|---|---|
| Toplu istekte satır | 1.000 |
| Uygulamaların yazabileceği yönlendirme | Mağaza başına toplam 100.000 (mağazanın kendi yazdıkları sayılmaz) |
| Adres ve hedef uzunluğu | 250 karakter |
Uygulama kaldırılınca
Uygulamanızın yazdığı yönlendirmeler silinmez; mağazanın eski adresleri çalışmaya devam eder. appPrefix alanı kaydın kaynağını göstermeye devam eder, mağaza bu kayıtları panelden yönetebilir.