URL-Prozent-Kodierer & -Dekodierer
Aus hello world & café wird hello%20world%20%26%20caf%C3%A9, bereit für einen Link. Wählen Sie zwischen einem einzelnen Wert, bei dem auch & = ? / maskiert werden, und einer ganzen Adresse, die Doppelpunkte, Schrägstriche und Fragezeichen behält. Dekodieren kehrt es um. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Text
- hello world & café
- Berechnungsmodus
- Encode
- Ergebnis
- hello%20world%20%26%20caf%C3%A9
- Länge
- 31
- Profil
- component
- Norm
- encodeURIComponent / decodeURIComponent
Die URL-Prozentkodierung verwandelt Leerzeichen, Kaufmanns-Und, Nicht-ASCII-Buchstaben und andere reservierte oder unsichere Zeichen in die übertragbare %HH-Form, damit Abfragezeichenketten, Pfadsegmente und Rückrufparameter den Weg durch Browser, Proxys und APIs überstehen. Ohne sie zerteilt ein Suchbegriff mit Leerzeichen die Abfrage, ein E-Mail-Betreff mit Akzenten beschädigt einen mailto-Link, und ein Produktname mit Schrägstrich sieht wie ein neuer Pfad aus. Wählen Sie den Komponentenmodus, wenn Sie einen einzelnen Parameterwert kodieren, oder den Voll-URI-Modus, wenn strukturelle Trennzeichen wie Doppelpunkt-Schrägstrich und Fragezeichen intakt bleiben sollen.
Wie Prozentkodierung und die beiden URL-Profile funktionieren
Die Prozentkodierung, für das Web in den URI-Standards definiert, denen Browser und RFC 3986 folgen, ersetzt jedes Byte, das in einem Kontext nicht erlaubt ist, durch ein Prozentzeichen und zwei Hexziffern. Bei UTF-8-Text werden Mehrbyte-Zeichen zu mehreren aufeinanderfolgenden %HH-Gruppen, sodass café zu caf%C3%A9 und ein einfaches Leerzeichen zu %20 wird. Zwei übliche Profile sind im Alltag wichtig.
Das Komponentenprofil entspricht encodeURIComponent: Es maskiert nahezu alles außer unreservierten Zeichen, einschließlich reservierter Trennzeichen wie Kaufmanns-Und, Gleichheitszeichen, Fragezeichen, Schrägstrich und Doppelpunkt. Genau das wollen Sie, wenn die Zeichenkette ein einzelner Abfrageparameterwert oder ein einzelnes Pfadsegment ist, das nicht mit Struktur verwechselt werden darf. Das Voll-URI-Profil entspricht encodeURI: Es maskiert weiterhin Leerzeichen und Nicht-ASCII, lässt aber strukturelle Satzzeichen unangetastet, sodass eine ganze Adresse wie https://example.com/path?
Bevor die eigentliche Dekodierung läuft, prüft diese Fähigkeit die Eingabe auf wohlgeformte Maskierungen: Jedem Prozentzeichen müssen genau zwei Hexziffern folgen.
Was Sie senden und was Sie zurückerhalten
Senden Sie ein erforderliches Zeichenkettenfeld namens text sowie die optionalen Felder mode und component. Fehlt mode, ist encode die Vorgabe, sodass eine einzelne Nutzlast dennoch nützliche Arbeit leistet. Der Modus encode prozentmaskiert text nach dem gewählten Profil und liefert die umgewandelte Zeichenkette in result.
Der Modus decode validiert jede Prozentfolge, kehrt dann die Kodierung um und liefert reinen UTF-8-Text in result. component ist standardmäßig true für das strenge Komponentenprofil; setzen Sie es auf false für das Voll-URI-Profil, das strukturelle Trennzeichen bewahrt. Die Antwort spiegelt mode, component, den ursprünglichen text, result, die Länge von result, eine kurze Profilangabe component oder uri und eine standard-Angabe, die die passenden JavaScript-Builtins nennt, damit Clients prüfen können, welchen Vertrag sie getroffen haben. Validierungsfehler verbrauchen kein vorausbezahltes Guthaben.
Wo URL-Prozentkodierung in der Praxis auftaucht
Backend-Dienste, die Weiterleitungsziele, OAuth-Rückruf-URLs und signierte Rücksprungpfade zusammensetzen, müssen jeden Parameterwert unabhängig kodieren, damit ein Kaufmanns-Und in einem Produkttitel kein zweites Abfragefeld erfindet. Frontend-Anwendungen, die Such- und Filterlinks aus Freitextfeldern bauen, brauchen Komponentenkodierung bei jedem Wert, während die Pfadvorlage unberührt bleibt. E-Mail- und SMS-Vorlagen mit Deep Links, Benutzernamen, Kampagnen-Tags oder Unicode-Betreffen verlassen sich auf Prozentkodierung, damit Anbieter und Clients das href nicht umbrechen oder beschädigen.
Support-Teams fügen halbkodierte Zeichenketten aus Tickets ein und brauchen einen Dekodierpfad, der bei abgeschnittenen %-Maskierungen laut scheitert, statt Zeichen zu erfinden. Lokalisierungs-Ingenieure prüfen, dass Mehrbyte-Sprachen den Hin- und Rückweg durch Kodieren und Dekodieren ohne Mojibake überstehen. Autoren von Web-Grundlagen-Lehrgängen wünschen eine eigene Seite für Prozentkodierung mit beiden Profilen, Komponenten- und Voll-URI, statt das Thema unter einem allgemeinen Base64- oder Slug-Werkzeug zu verstecken, weil Suchabsicht und Reserviertzeichen-Regeln sich unterscheiden.
Wenn Sie Base64, Base32, Slug-Erzeugung, UTM-Zusammenbau oder vollständige URL-Strukturvalidierung brauchen, behandeln Sie diese als eigene Suchabsichten und Seiten, statt diese Prozent-Kodierer-Seite zu überladen.
Anwendungsfälle
Sichere Abfrageparameterwerte
Kodieren Sie jeden Filter, Suchbegriff oder Produktnamen im Komponentenmodus prozentual, damit reservierte Zeichen die Abfragezeichenkette nie zerteilen oder umschreiben.
Eingefügte oder protokollierte URLs dekodieren
Dekodieren Sie prozentkodierte Fragmente aus Protokollen und Tickets zurück zu lesbarem Text – mit harten Fehlern bei unvollständigen oder Nicht-Hex-Prozentfolgen.
Häufige Fragen
Was unterscheidet component true von false?
True nutzt encodeURIComponent-Semantik und maskiert reservierte Trennzeichen wie & = ? / :, damit ein einzelner Wert in einem Parameter oder Pfadsegment sicher ist. False nutzt encodeURI-Semantik und bewahrt strukturelle URL-Satzzeichen, maskiert aber weiterhin Leerzeichen und Nicht-ASCII.
Kann ich sowohl kodieren als auch dekodieren?
Ja. Setzen Sie mode auf encode (Vorgabe), um reinen Text prozentual zu maskieren, oder mode auf decode, um Text aus einer prozentkodierten Zeichenkette zurückzugewinnen.
Ersetzt das den Aufbau eines vollständigen URL-Objekts?
Nein. Es wandelt Text nur nach den Regeln der Prozentkodierung um.
Was passiert bei einer kaputten Prozentfolge?
Das Dekodieren bricht mit einer klaren Meldung und der Position des Fehlers ab. Ein einzelnes % am Ende oder Folgen wie %G1 oder %2 werden abgelehnt statt halb dekodiert, damit ein Einfügefehler nicht zu anderem Text wird.
Warum wird aus café caf%C3%A9?
Weil der Text zuerst in UTF-8-Bytes umgewandelt wird und das é zwei Bytes belegt. Jedes Byte, das in einer URL nicht erlaubt ist, wird zu einem Prozentzeichen mit zwei Hexziffern, ein Leerzeichen etwa zu %20.
Verwandte Tools
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
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/enc/url \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"hello world & café"}'const res = await fetch("https://api.kit.forhosting.com/enc/url", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "hello world & café"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/url",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "hello world & café"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/url", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"hello world & café"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"hello world & café"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/url", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"text": "hello world & café"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.url",
"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
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
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. |
Technische Hinweise
Diese Fähigkeit wendet dieselben Regeln an, die JavaScript als encodeURIComponent und encodeURI bereitstellt: Der Modus encode maskiert die Zeichen, die Ihr Profil verlangt, der Modus decode stellt reinen Text wieder her, und jede fehlerhafte Prozentfolge scheitert sofort mit invalid_input, statt halb dekodierten Datenmüll zurückzugeben.
Wie Prozentkodierung und die beiden URL-Profile funktionieren
x=1 leicht normalisiert werden kann, ohne das Gerüst aus Schema, Pfad oder Abfrage zu zerstören. Das Dekodieren kehrt die Abbildung um. Ein einsames Prozent am Ende oder Folgen wie %G1 oder %2 lösen invalid_input mit Position und kurzer Erklärung aus. Diese strenge Prüfung ist Absicht; stilles Akzeptieren würde Einfügefehler verbergen und in Sprachen, die defekte Maskierungen unterschiedlich behandeln, abweichende Ergebnisse erzeugen. Der Pfad ist reine Zeichenkettenarbeit ohne Netzwerk, Zufallsstartwerte und Uhrzeitstempel, sodass identische Eingaben stets identisches JSON erzeugen. Der Preis erfolgreicher API-Aufrufe ist die veröffentlichte Basis von $0.002 pro item, und Validierungsfehler verbrauchen kein vorausbezahltes Guthaben.
Was Sie senden und was Sie zurückerhalten
Fehlender text, Objekte ohne Zeichenkettentyp, nicht unterstützte mode-Werte, Werte, die für component nicht als boolesch lesbar sind, Zeichenketten über dem dokumentierten Maximum, unvollständige Prozentmaskierungen, Nicht-Hex-Ziffern nach einem Prozentzeichen und URI-Fehler auf Hostebene bei ungültig dekodiertem UTF-8 scheitern allesamt mit invalid_input und einer klaren englischen Meldung. Klassische Prüfungen sind das Kodieren von hello world mit Leerzeichen und Kaufmanns-Und im Komponentenmodus, das Dekodieren von caf%C3%A9 zurück zu café, das Kodieren einer vollständigen URL mit component false, damit Schema- und Abfragetrenner bestehen bleiben, und das Zurückweisen einer Zeichenkette, die mit einem bloßen Prozent endet. Der Preis erfolgreicher API-Aufrufe ist die veröffentlichte Basis von $0.002 pro item.
Wo URL-Prozentkodierung in der Praxis auftaucht
Da diese Fähigkeit eine reine parse-Engine ist, beträgt der API-Preis die veröffentlichte Basis von $0.002 pro erfolgreichem item, und fehlgeschlagene Validierung wird nicht berechnet.
Integrationsbeispiele
Leichte Normalisierung ganzer URLs
Kodieren Sie eine vollständige Adresse mit component false, damit Leerzeichen und Nicht-ASCII maskiert werden, während Schema-, Pfad- und Abfragetrenner intakt bleiben.
Technische Fragen
Was passiert bei einer fehlerhaften Prozentfolge?
Das Dekodieren scheitert mit invalid_input und nennt Position und fehlerhafte Maskierung (zum Beispiel ein unvollständiges % oder Nicht-Hex-Ziffern). Validierungsfehler werden nicht berechnet.
Was kostet das?
Das Browser-Werkzeug ist kostenlos und läuft lokal. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 pro erfolgreichem item; ungültige Eingaben werden nicht berechnet.