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.

404'ü sunucu tarafında yakalar — silinmiş ürün ve kategoriler dahil —, no404'e sorar ve gerçek bir 301 döndürür. Override kullanmaz, tema dosyalarına dokunmaz.

• PrestaShop 9.0+ → 2.x hattı (PHP 8.1+) · PrestaShop 8.0–8.2 → 1.x hattı (PHP 7.2+) · cURL eklentisi ve dostu URL'ler (SEO URL'leri) açık olmalı
• Sonuçları mağaza başına yerel önbelleğe alır; çoklu mağazada her mağaza kendi API anahtarını tutabilir.
• no404 yanıt vermezse mağazanızın kendi 404 sayfası gösterilir; 1,5 sn zaman aşımı ve devre kesici mağazayı asla bekletmez.

Kurulum

1. Mağazanızın sürümüne uygun zip'i indirin: PrestaShop 9 → 2.x, PrestaShop 8 → 1.x.
2. Modüller → Modül Yöneticisi → Modül yükle ile zip'i açmadan yükleyin.
3. no404 → Yapılandır ekranında panelden aldığınız API anahtarını yapıştırıp bağlantıyı test edin.

Uygulamanız 404 döndürdüğünde (eşleşmeyen rota, abort(404), findOrFail, Route::fallback()) no404'e sorar ve gerçek bir 301 ya da 302 döndürür. Middleware kendini kaydeder; exception handler'ınıza dokunmanız gerekmez.

• Laravel 12 · 13 · PHP 8.2+ (Laravel 13 için 8.3+) · istekler arasında kalıcı bir önbellek deposu (redis, database, file…)
• Yanıtları yol başına önbelleğe alır, eşleşmeyenler dahil. Statik dosyalar, /storage, /livewire, /api ve yönetim yolları hiç sorulmaz.
• no404 yavaş ya da erişilemezse ziyaretçi en geç 1,5 sn içinde uygulamanızın kendi 404 sayfasını görür; sorgular bir dakika duraklar.

Kurulum

Paketi kurun:

composer require no404/laravel

Panelden aldığınız API anahtarını .env dosyasına ekleyin:

NO404_API_KEY=SENIN_API_ANAHTARIN

Bağlantıyı kontrol edin, sonra panelde Entegrasyon → Test et ile doğrulayın:

php artisan no404:test

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?path=" + encodeURIComponent(path),
  { headers: { Authorization: "Bearer SENIN_API_ANAHTARIN" } }
);
const data = await res.json();

// redirectStatus, panelde seçtiğiniz 301 eşiğine göre 301 ya da 302 gelir.
if (data.redirect) {
  const status = data.redirectStatus === 301 ? 301 : 302;
  // Express: res.redirect(status, 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.

Anahtar iki yoldan gönderilebilir: adreste (/api/v1/resolve/ANAHTAR) ya da Authorization: Bearer başlığında (/api/v1/resolve). Tarayıcı snippet'i adresi kullanır; sunucu tarafı entegrasyonlar başlığı kullanmalı, çünkü adresteki anahtar sunucu ve proxy günlüklerine düşer, başlık düşmez.

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şlıkla (sunucu tarafı için önerilen)

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

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",
  "redirectStatus": 301
}

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.