T-SOFT/Admin API/URL Yönlendirmeleri

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.

Kapsam: okuma 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/ ile eski-urun aynı adrestir).
  • Vitrin adresi sorgu parametreleriyle birlikte birebir arar, bulamazsa parametreleri atıp yeniden arar. eski?renk=mavi ve eski?beden=m&renk=mavi ayrı adreslerdir; parametre sırası normalize edilmez.

Yönlendirme ekleme

POST /config/redirect-links
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"
      }
    }
  }'
AlanZorunluAçıklama
seoLinkEvetYönlendirilecek eski adres, mağaza içinde bir yol (ör. eski-urun, kategori/eski). En fazla 250 karakter
redirectLinkHayırHedef yol (ör. yeni-urun). Boş bırakılırsa ana sayfaya yönlenir. En fazla 250 karakter
languageHayırDil kodu; verilmezse isteğin dili
linkTypeHayırYalnı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

DurumSonuç
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ıyor422. Uygulamalar yalnız mağazanın kendi adreslerine yönlendirebilir
Boş yol, tam adres ya da ? ile başlayan yol422
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 ait422
Adreste zaten yönlendirme var422

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.

POST /config/redirect-links/-actions/batch
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" }
    ]
  }'
200 OK
{
  "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 404 alırsınız.

Sınırlar

SınırDeğer
Toplu istekte satır1.000
Uygulamaların yazabileceği yönlendirmeMağaza başına toplam 100.000 (mağazanın kendi yazdıkları sayılmaz)
Adres ve hedef uzunluğu250 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.