SEO-History-Endpunkt: 301-Weiterleitungen

v2.6.0 · CRUD · SEO Redirects

SEO History

Verwalten Sie 301-Weiterleitungen per API. SEO-History-Einträge werden auch automatisch erstellt, wenn sich der seo_name beim Product/Category-Import ändert.

GET    /Export/JSON/seohistory
POST   /Import/JSON/seohistory
PUT    /Import/JSON/seohistory
DELETE /Delete/JSON/seohistory/{id}

Endpoints

Methode	Endpoint	Scope	Beschreibung
GET	`/Export/JSON/seohistory`	`seohistory:read`	Alle SEO-Weiterleitungen auflisten
GET	`/Export/JSON/seohistory/{id}`	`seohistory:read`	Einzelne Weiterleitung
POST	`/Import/JSON/seohistory`	`seohistory:write`	Neue Weiterleitung anlegen
PUT	`/Import/JSON/seohistory`	`seohistory:write`	Bestehende Weiterleitung aktualisieren
DELETE	`/Delete/JSON/seohistory/{id}`	`seohistory:delete`	Einzeln per ID löschen
DELETE	`/Delete/JSON/seohistory`	`seohistory:delete`	Bulk/Filter-Löschung

Query-Filter (GET)

Parameter	Beschreibung	Beispiel
`?type=`	Entitäts-Typ (`p`=Produkt, `c`=Kategorie, `m`=Hersteller, `s`=CMS, `n`=News)	`?type=p`
`?base_id=`	Quell-Entitäts-ID	`?base_id=70`
`?language=`	Sprache (ISO-Code oder ID)	`?language=de`

Datenstruktur

Felder

Feld	Typ	Beschreibung
`sh_id`	INT	Primärschlüssel
`sh_base_id`	INT	ID der Quell-Entität
`sh_base_type`	ENUM	`c`=Kategorie, `s`=CMS, `m`=Hersteller, `p`=Produkt, `n`=News, `o`=Sonstige
`sh_item_id`	INT	ID der Ziel-Entität
`sh_item_type`	ENUM	Typ der Ziel-Entität (gleiche Werte)
`sh_deletestamp`	DATETIME	Automatische Löschung (Standard: +1 Jahr)

Sprach-Felder

Feld	Typ	Beschreibung
`sh_seo_string`	VARCHAR(255)	Alter SEO-Pfad (ohne Domain, ohne führenden Slash)

Request-Beispiele

POST — Neue Weiterleitung

{
  "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 — Bulk & Filter

# Bulk per JSON-Body
DELETE /Delete/JSON/seohistory
{"sh_id": [42, 43, 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

Auto-Redirect

Automatische SEO-History-Einträge beim Import

Automatisch: Wenn sich der seo_name (oder der Name selbst, mit entsprechender Auto-Regenerierung) beim JSON-Import (PUT) ändert, wird automatisch ein SEO-History-Eintrag für den alten Pfad erstellt — analog zum XML-Import. Ablaufzeit: 1 Jahr. Duplikate werden erkannt und verhindert (idempotent).

Unterstützt seit v2.13.0: Alle fünf Entity-Typen mit SEO-URLs:

Products (p) — sprachspezifisch
Categories (c) — sprachspezifisch
Manufacturers (m) — sprachunabhängig (ein Eintrag, eine description-Zeile pro Sprache)
News (n) — sprachspezifisch
CMS (s) — sprachspezifisch

SEO History verwalten

Erstellen Sie einen OAuth2 Client mit seohistory:read, seohistory:write und seohistory:delete Scopes.

OAuth2 Client erstellen