Point de terminaison de l'historique SEO : redirections 301

Trois filtres précis permettent, à partir d’une adresse connue (Search Console, ancien plan du site, e-mail client), d’identifier la catégorie, l’article ou la destination d’une redirection : ?seo_string= vers /categories et /seohistorys, ?seo_name= vers /products. Jusqu’à la version v2.122.10, les noms indiqués étaient UNKNOWN_FILTER, et la liste était fournie sans filtrage.

Étape par étape

1. Supprimer l'hôte, la partie requête (?…) et l'ancre (#…) : https://shop.de/lng/en/fishing-rods/spinning-rods/ devient lng/en/fishing-rods/spinning-rods/.
2. Si le chemin commence par lng/xx/: omettre ce segment et envoyer à la place ?language=xx. Sans segment, c’est la langue par défaut de la boutique, par exemple ?language=de.
3. Si le reste commence par un préfixe d’adresse tel que brand, cms, news ou badge (dans les boutiques plus anciennes, également manufacturer et blog), il s’agit d’un fabricant, d’une page CMS, d’un article d’actualité ou d’un badge produit. Pour ces adresses et pour les pages de boutique portant leur propre nom, les filtres n’existent pas.
4. Si le chemin se termine par .html, il s'agit d'un article : /products?seo_name= avec le dernier segment sans .html (…/angelrute-xy.html → seo_name=angelrute-xy).
5. Si le chemin se termine par /, il s'agit d'une catégorie : /categories?seo_string= avec le chemin complet.
6. Aucun résultat : l'historique SEO. La destination d'une redirection se trouve dans sh_item_type et sh_item_id (p article, c catégorie, s page CMS, m fabricant, n actualités). Pour une catégorie, effectuer la recherche avec le chemin complet. Pour un article, commencer par le chemin complet (?seo_string=alte-kategorie/alter-artikel.html), puis, en l'absence de résultats, avec le dernier segment sans .html (?seo_string=alter-artikel) : en règle générale, SEO History ne répertorie un article renommé que sous son ancien slug.

# Kategorie zu https://shop.de/lng/en/fishing-rods/spinning-rods/
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/Export/JSON/categories?seo_string=fishing-rods/spinning-rods&language=en"

# Artikel zu https://shop.de/angelruten/angelrute-xy.html (nur die Artikelnummer)
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/Export/JSON/products?seo_name=angelrute-xy&fields=products_model"

# Wohin leitet https://shop.de/alte-kategorie/alter-artikel.html um? Erst der ganze Pfad …
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/Export/JSON/seohistorys?seo_string=alte-kategorie/alter-artikel.html&language=de"
# … ohne Treffer der alte Slug
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://shop.de/xpanel/xoport/Export/JSON/seohistorys?seo_string=alter-artikel&language=de"

Recherche dans l’historique SEO

• La recherche s'effectue sur l'adresse telle qu'elle apparaît dans la barre d'adresse, les caractères spéciaux étant donc codés en pourcentage. Elle est à nouveau codée en tant que valeur de requête (curl -G --data-urlencode, rawurlencode()) : k%C3%BCche-alt devient k%25C3%25BCche-alt dans la partie requête. Le filtre de la version 4.9 de la boutique ne trouve pas d'autres variantes de la même adresse (décodées küche-alt ou réécrites kueche-alt).
• Exactement, sans préfixe ni motif : % et _ sont des caractères. La casse (majuscules/minuscules), les barres obliques externes et .html n’ont aucune importance.
• Si une adresse comporte plusieurs entrées, elles sont toutes affichées, la plus récente ( sh_id ) en premier. La boutique elle-même retient la dernière entrée après sh_timestamp en fonction du type de destination de la page (p pour une adresse sur .html, c pour une adresse sur /) ; s’il n’y en a pas, elle retient la dernière entrée, quel que soit son type ; si vous souhaitez reproduire ce choix, triez les entrées de cette manière. Le filtre fournit également les entrées expirées (sh_deletestamp ) ; la boutique ne les redirige plus.
• Le filtre fonctionne conjointement avec ?type=, ?base_id= et /seohistory/{id}. Cas d'erreur : API d'exportation.

POST — Nouvelle redirection

{
  "type": "seohistory",
  "data": [{
    "sh_base_id": 70,
    "sh_base_type": "c",
    "sh_item_id": 102,
    "sh_item_type": "c",
    "sh_deletestamp": "2027-02-24 00:00:00",
    "languages": {
      "de": {"sh_seo_string": "alte-kategorie/alte-unterkat"},
      "en": {"sh_seo_string": "old-category/old-subcat"}
    }
  }]
}

DELETE — Traitement en masse et filtrage

# Bulk per JSON-Body: die sh_id aus dem GET
DELETE /Delete/JSON/seohistory
{"type": "seohistory", "data": [{"sh_id": 42}, {"sh_id": 43}, {"sh_id": 44}]}

# Abgelaufene Einträge bereinigen
DELETE /Delete/JSON/seohistory?expired=1

# Filter nach Typ und Quell-ID
DELETE /Delete/JSON/seohistory?type=p&base_id=123