DokumentationDynamic Media Image Serving and Rendering API

Grundlegende Syntax des Image Serving-HTTP-Protokolls image-serving-http-protocol-basic-syntax

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

Die grundlegende Syntax des HTTP-Protokolls lautet wie folgt:

request
http:// server/is/image[/ object][? modifiers]
server
server_address[: port]
Objekt
Source-Objektspezifikator (Bildpfad oder Eintrag im Bildkatalog).
Modifikatoren
modifier*[& modifier]
modifier
command|{$ macro$}|{. comment
Befehl
{ cmdName|{$ var}[= value]
macro
Name eines Befehlsmakros.
Kommentar
Kommentar-Zeichenfolge (vom Server ignoriert).
cmdName
Einer der unterstützten Befehl- oder Attributnamen.
var
Name einer benutzerdefinierten Variablen.
value
Befehls- oder Variablenwert.

Bei server_address, cmdName, macro und var wird nicht zwischen Groß- und Kleinschreibung unterschieden. Der Server behält die Groß-/Kleinschreibung aller anderen Zeichenfolgenwerte bei.

value ist befehlsspezifisch und kann aus einem oder mehreren durch Kommas getrennten Werten bestehen. Weitere Informationen finden Sie in der Beschreibung der einzelnen Befehle .

Server-Kennung section-926ae55ddba14b8d952147a5fd701e14

Der Stammkontext von /is/image ist für alle HTTP-Anfragen an Image Serving erforderlich.

HTTP-Dekodierung section-20922baccd804d2d986b44ce9a183a7d

Image Serving extrahiert zunächst object und modifiers aus der eingehenden Anfrage. object wird dann in Pfadelemente aufgeteilt, die einzeln HTTP-dekodiert sind. Die Zeichenfolge modifiers wird in command= value -Paare aufgeteilt, und value wird dann vor der befehlsspezifischen Verarbeitung HTTP-dekodiert.

NOTE
Sofern in der Dokumentation nicht anders angegeben, müssen alle unsicheren Zeichen gemäß dem HTTP-Standard kodiert werden. Weitere Informationen finden Sie in der HTTP-Spezifikation .

Kommentare section-69ef0be0f17a418c87a0eba21c2ddb00

Kommentare können überall in Anforderungszeichenfolgen eingebettet werden und werden durch einen Punkt (.) identifiziert unmittelbar auf das Befehlstrennzeichen (&) folgen. Der Kommentar wird durch das nächste Vorkommen eines (nicht kodierten) Befehlstrennzeichens beendet. Mit dieser Funktion können Informationen zur Anforderung hinzugefügt werden, die nicht für die Image-Serving-Verwendung vorgesehen ist, z. B. Zeitstempel und Datenbank-IDs.

Verwandte Themen section-d0b836568c31454b8dbeb136e6bbe0f0

Datentypen, HTTP/1.1-Spezifikation

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49