URL-Kodierung

URLs dürfen nur eine begrenzte Menge an Zeichen enthalten, die in RFC 3986 definiert sind. Sonderzeichen oder Nicht-ASCII-Zeichen (z.B. deutsche Umlaute) müssen kodiert werden, um Konflikte oder Missverständnisse zu vermeiden.

Was ist URL-Kodierung?

URL-Kodierung ist ein Verfahren, um spezielle Zeichen in einer URL in ein sicheres Format zu konvertieren. Das ist wichtig, weil URLs nur bestimmte Zeichen enthalten dürfen, wie Buchstaben (A-Z, a-z), Zahlen (0-9) und einige Symbole (-, _, .).

Zeichen, die diese Regel nicht erfüllen, wie Leerzeichen, # oder nicht-englische Buchstaben (ä, ë, à), müssen kodiert werden. Andere Zeichen (z.B. /, ?, &) haben eine feste Bedeutung für URLs und dürfen nur kodiert als Parameterwerte in einer Abfrage genutzt werden.

Bei der Kodierung wird jedes Zeichen durch eine Kombination ersetzt aus:

1. Einem Prozentzeichen (%).
2. Zwei hexadezimalen Ziffern, die den ASCII- oder UTF-8-Wert des Zeichens darstellen.

Im Kontext der CodeListHub-API betrifft dies vor allem die Werte und regulären Ausdrücke in den URL-Parametern searchTerm, canonicalUri und canonicalVersionUri.

Welche Zeichen müssen kodiert werden?

1. Sonderzeichen und Leerzeichen:

   • Ein Leerzeichen wird zu %20.
   • & wird zu %26.
   • = wird zu %3D.
   • etc.

2. Nicht-englische Buchstaben (Umlaute, Akzente usw.):

   • ä wird zu %C3%A4.
   • ö wird zu %C3%B6.
   • à wird zu %C3%A0.
   • ë wird zu %C3%AB.
   • etc.

3. Andere spezielle Symbole:

   • # wird zu %23.
   • + wird zu %2B.
   • / wird zu %2F.
   • etc.

Beispiel

Das folgende CodeListHub-API-Beispiel liefert alle Dokumenteneinträge zurück, deren Name mit ISO beginnt:

• Im Orginal:

  Powershell 7Bash

  curl -X GET 'https://api.codelisthub.org/v1/documents/index?searchTerm=^ISO' -H 'accept: text/json' | ConvertFrom-Json | ConvertTo-Json
  

  curl -X GET 'https://api.codelisthub.org/v1/documents/index?searchTerm=^ISO' -H 'accept: text/json' | json_pp
  

• Mit URL-Kodierung:

  Powershell 7Bash

  curl -X GET 'https://api.codelisthub.org/v1/documents/index?searchTerm=%5EISO' -H 'accept: text/json' | ConvertFrom-Json | ConvertTo-Json
  

  curl -X GET 'https://api.codelisthub.org/v1/documents/index?searchTerm=%5EISO' -H 'accept: text/json' | json_pp
  

  Hier wurde der Zirkumflex ^ des regulären Ausdrucks mit %5E kodiert.

Werkzeug

Das folgende Werkzeug hilft dir dabei, einen beliebigen Wert zu kodieren. Tippe dazu den Text in das erste Textfeld ein und klicke auf "Kodieren".

Kodieren

Das URL-kodierte Ergebnis siehst Du hier:

Kodierungslisten

Lateinische Zeichen mit Akzenten und Diakritika

Sonderzeichen