ForHosting KIT · Websites auslesen & überwachen

Slug auf Eindeutigkeit und Format prüfen

Prüfen Sie einen vorgeschlagenen URL-Slug, bevor er ein CMS, eine Deployment-Pipeline oder eine Routing-Tabelle erreicht.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Das Werkzeug erzwingt zuerst ein eindeutiges Format aus Kleinbuchstaben, Ziffern und einzelnen Bindestrichen. Danach vergleicht es den gültigen Vorschlag mit den von Ihnen angegebenen vorhandenen Slugs. Ein ungültiges Format führt immer zu einem Fehler, selbst wenn derselbe Text in der Liste steht. Gültige Ergebnisse zeigen klar, ob der Slug eindeutig ist und eine exakte Kollision gefunden wurde.

Validieren Sie den Slug vor der Verfügbarkeitsprüfung

Ein Eindeutigkeitsergebnis ist nur sinnvoll, wenn der vorgeschlagene Wert sicher Bestandteil einer URL sein kann. Geben Sie den Kandidaten und die bereits von Ihrer Website, Anwendung oder Inhaltsablage verwendeten Slugs an. Zulässig sind englische Kleinbuchstaben von a bis z, Ziffern von 0 bis 9 und Bindestriche zwischen nicht leeren Gruppen. Großbuchstaben, Leerzeichen, Unterstriche, Satzzeichen sowie führende, abschließende oder wiederholte Bindestriche werden abgelehnt. Die Reihenfolge ist streng: Die Formatprüfung erfolgt vor dem Listenvergleich. Ein ungültiger Kandidat, der zugleich in der Liste steht, erzeugt daher einen Eingabefehler und kein gewöhnliches Kollisionsergebnis. Formulare, Massenimporte und Deployments erhalten damit eine stabile Regel. Beachten Sie die Längenbegrenzung und senden Sie den aktuellen Bestand als String-Array; es findet keine versteckte Normalisierung statt.

Deuten Sie exakte Kollisionsergebnisse richtig

Bei einem korrekt formatierten Kandidaten enthält die Antwort den übermittelten Slug, bestätigt das gültige Format und meldet zwei komplementäre Werte: Eindeutigkeit und Kollision. Eine Kollision liegt vor, wenn die exakte Zeichenfolge mindestens einmal in der übermittelten Liste vorkommt. Der Vergleich ist bewusst exakt: Das Werkzeug entfernt keine Präfixe, dekodiert keine URL-Escapes, kürzt keine Listeneinträge und setzt ähnliche Ausdrücke nicht gleich. So bleiben produkt-leitfaden und produkt-leitfaeden zwei verschiedene gültige Routen. Dieses Verhalten ist deterministisch und überlässt Ihrer Anwendung Regeln für reservierte Namen, Sprachpräfixe, Weiterleitungen oder Datenbankvorgaben. Doppelte Listeneinträge ändern das Ergebnis nicht. Da die Liste die aktuelle Wahrheitsquelle der Anfrage darstellt, sollten Sie sie aktualisieren, wenn mehrere Redaktionen oder Prozesse gleichzeitig Routen beanspruchen können.

Nutzen Sie die Prüfung bei Veröffentlichung und Deployment

Führen Sie die Prüfung möglichst nahe an der Reservierung einer Route aus. In einem Editor prüfen Sie nach der Erzeugung des Slugs aus einem Titel und erneut nach jeder Änderung. Bei statischen Websites sammeln Sie zuerst die Ausgabepfade und testen jeden Vorschlag gegen die bereits akzeptierten Pfade. In einer API oder Migration behandeln Sie Eingabefehler als zu korrigierende Qualitätsmängel und Kollisionen als Namensentscheidung. Der Vorgang ist deterministisch, greift nicht auf das Netzwerk zu und speichert nichts; dadurch eignet er sich für Tests und reproduzierbare Builds. Er prüft jedoch nur und reserviert nicht: Nach dem Lesen Ihrer Liste kann ein anderer Prozess den Slug beanspruchen. Bei parallelen Schreibvorgängen benötigen Sie zusätzlich eine Eindeutigkeitsbedingung in der Datenbank oder eine atomare Reservierung beim Speichern.

Anwendungsfälle

Routenkollisionen im CMS verhindern

Prüfen Sie einen vorgeschlagenen Pfad und warnen Sie, wenn ein Beitrag exakt diesen Slug verwendet.

Builds statischer Websites absichern

Vergleichen Sie erzeugte Slugs vor dem Schreiben oder Deployment mit akzeptierten Ausgabepfaden.

Migrationseingaben bereinigen

Trennen Sie fehlerhafte alte Slugs von gültigen Namen, die während der Migration lediglich kollidieren.

Häufige Fragen

Welches Slug-Format ist zulässig?

Ein oder mehrere Kleinbuchstaben oder Ziffern, optional durch einzelne Bindestriche getrennt. Bindestriche dürfen nicht führen, enden oder doppelt stehen.

Was geschieht, wenn ein ungültiger Slug auch in der Liste steht?

Das Werkzeug meldet einen Eingabefehler, weil die Formatvalidierung stets Vorrang vor der Kollisionsprüfung hat.

Ignoriert der Kollisionsvergleich die Groß- und Kleinschreibung?

Nein. Der Vergleich ist exakt. Großbuchstaben sind im Vorschlag ohnehin ungültig, und die Liste wird nicht normalisiert.

Reserviert ein eindeutiges Ergebnis den Slug?

Nein. Es prüft nur die übermittelte Liste. Verhindern Sie parallele Ansprüche mit atomarem Schreiben oder einer Eindeutigkeitsbedingung.

Was kostet eine API-Anfrage?

Der Grundpreis beträgt $0.002 pro Anfrage. Dieselbe deterministische Logik kann im Browser ausgeführt werden.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/web/slug-uniqueness-check

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/web/slug-uniqueness-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"summer-sale-2026","existing_slugs":["spring-sale-2026","clearance"]}'

const res = await fetch("https://api.kit.forhosting.com/web/slug-uniqueness-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "slug": "summer-sale-2026",
    "existing_slugs": [
      "spring-sale-2026",
      "clearance"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/slug-uniqueness-check",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "slug": "summer-sale-2026",
    "existing_slugs": [
        "spring-sale-2026",
        "clearance"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/slug-uniqueness-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"slug":"summer-sale-2026","existing_slugs":["spring-sale-2026","clearance"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"slug":"summer-sale-2026","existing_slugs":["spring-sale-2026","clearance"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/slug-uniqueness-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "slug": "summer-sale-2026",
  "existing_slugs": [
    "spring-sale-2026",
    "clearance"
  ]
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.slug_uniqueness_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

`max_existing_slugs`	10000
`max_slug_length`	200

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →