Entegrasyon

Üçü de ziyaretçiyi doğru sayfaya götürür. Fark sunucunun döndürdüğü HTTP durumundadır ve bu fark SEO'da belirleyicidir: 301 alan bir adres birikmiş değerini yenisine taşır, 404 kalan bir adres taşımaz.

404'ü sunucu tarafında yakalar, no404'e sorar ve gerçek bir 301 döndürür. Tema dosyalarına dokunmaz, kod yazmanızı gerektirmez.

• WordPress 6.0+ · PHP 7.4+
• Sonuçları yerel olarak önbelleğe alır — kotanızı ve hız sınırını korur.
• no404 yanıt vermezse sayfa normal 404'üne düşer (fail-open); eklenti siteyi asla bekletmez.

Kurulum

1. WordPress yönetiminde Eklentiler → Yeni Ekle bölümünde no404 aratın.
2. Şimdi Kur deyip etkinleştirin.
3. Panelden aldığınız API anahtarını eklenti ayarlarına yapıştırın.

Kendi kodunuzu yazıyorsanız 404 ürettiğiniz yerde no404'e sorup gerçek bir 301 döndürebilirsiniz. Bunu sıfırdan kurgulamanız gerekmiyor: panel, siteniz için hazır bir entegrasyon şartnamesi üretir.

Şartname bir kod parçası değil, bir mühendislik belgesidir: zaman aşımı, zorunlu önbellek, kara liste, 301/302 kuralı, döngü ve açık yönlendirme koruması dahil. Dosyayı geliştiricinize ya da doğrudan kod yazan bir yapay zekâ ajanına verirsiniz.

En yalın hâli (Node.js)

const res = await fetch(
  "https://www.no404.tr/api/v1/resolve/SENIN_API_ANAHTARIN?path=" + encodeURIComponent(path),
  { headers: { Origin: "https://siteniz.com" } }
);
const data = await res.json();

// REDIRECT ya da yüksek skorlu CATALOG → kalıcı (301); gerisi geçici (302).
if (data.redirect) {
  const permanent = data.source === "REDIRECT" || data.score >= 0.5;
  // örn. Express: res.redirect(permanent ? 301 : 302, data.redirect);
}

Aşağıdaki kodu sitenizin 404 sayfasına ekleyin. SENIN_API_ANAHTARIN yerine panelden aldığınız API anahtarını yazın.

<!-- no404: 404 sayfanıza ekleyin -->
<script>
(function () {
  var p = location.pathname + location.search;
  var ref = document.referrer;
  fetch("https://www.no404.tr/api/v1/resolve/SENIN_API_ANAHTARIN?path=" + encodeURIComponent(p) + "&ref=" + encodeURIComponent(ref))
    .then(function (r) { return r.json(); })
    .then(function (d) { if (d && d.redirect) location.replace(d.redirect); })
    .catch(function () {});
})();
</script>

Next.js (App Router)

app/not-found.tsx içine:

"use client";
import { useEffect } from "react";

export default function NotFound() {
  useEffect(() => {
    const p = location.pathname + location.search;
    fetch(`https://www.no404.tr/api/v1/resolve/SENIN_API_ANAHTARIN?path=${encodeURIComponent(p)}&ref=${encodeURIComponent(document.referrer)}`)
      .then((r) => r.json())
      .then((d) => { if (d.redirect) location.replace(d.redirect); })
      .catch(() => {});
  }, []);
  return <p>Sayfa bulunamadı, yönlendiriliyorsunuz…</p>;
}

Üç yolun da kullandığı tek endpoint; hem GET hem POST destekler.

GET örneği

curl "https://www.no404.tr/api/v1/resolve/SENIN_API_ANAHTARIN?path=/14-gram-altin-yuzuk-102" \
  -H "Origin: https://siteniz.com"

POST örneği

curl -X POST "https://www.no404.tr/api/v1/resolve/SENIN_API_ANAHTARIN" \
  -H "Content-Type: application/json" \
  -H "Origin: https://siteniz.com" \
  -d '{"path":"/14-gram-altin-yuzuk-102"}'

Başarılı yanıt JSON döner:

{
  "success": true,
  "found": true,
  "redirect": "https://siteniz.com/14-gram-altin-yuzuk",
  "score": 0.92,
  "source": "CATALOG"
}

Yanıt alanları

Durum kodları

API anahtarınız origin kilidi ile korunur. İstekler yalnızca panelde tanımladığınız izinli origin'lerden kabul edilir. Anahtarınız sızsa bile başka bir alan adından gelen tarayıcı isteği 403 ile reddedilir ve CORS yanıtı verilmez.

• Sitenizi eklediğinizde alan adınız otomatik izinli origin olarak eklenir (www + köksüz).
• Ek alan adlarını panelden ekleyebilirsiniz.
• Anahtar sızıntısında panelden anahtarı yenileyin; eski anahtar o an geçersiz olur.

• Sunucu tarafını tercih edin: 301 üreten tek yol odur; snippet SEO değerini taşımaz.
• Yanıtları önbelleğe alın: sunucu tarafı entegrasyonda bu opsiyonel değildir — tüm trafik tek IP'den sayılır.
• Sitemap'inizi bağlayın: eşleştirme kalitesi kataloğunuzun güncelliğine bağlıdır.
• Eşiği gözden geçirin: çok agresif yönlendirme istemiyorsanız eşiği yükseltin (önerilen 0.3).
• Kritik yollar için manuel yönlendirme tanımlayın; otomatik eşleştirmeyi ezer.
• Hız sınırı: anahtar + IP başına dakikada 120 istek.