DokumentationDynamic Media Image Serving and Rendering-API

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

Last update: Thu Dec 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

Die grundlegende Syntax des HTTP-Protokolls sieht wie folgt aus:

Anfrage
http:// server/is/image[/ object][? Modifikatoren]
Server
server_address[: port]
Objekt
Source-Objektbezeichner (Bildpfad oder Bildkatalogeintrag).
Modifikatoren
Modifikator*[& Modifikator]
Modifikator
Befehl|{$ Makro$}|{. Kommentar}
Befehl
{ cmdName|{$ var}}[= Wert]
Makro
Name eines Befehlsmakros.
Kommentar
Kommentarzeichenfolge (vom Server ignoriert).
cmdName
Einer der unterstützten Befehls- oder Attributnamen.
var
Name einer benutzerdefinierten Variablen.
Wert
Wert des Befehls oder der Variablen.

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 Werten bestehen, die durch Kommas getrennt sind. Weitere Informationen finden Sie in der Beschreibung der einzelnen Befehle.

Server-Kennung section-926ae55ddba14b8d952147a5fd701e14

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

HTTP-Dekodierung section-20922baccd804d2d986b44ce9a183a7d

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

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

Kommentare section-69ef0be0f17a418c87a0eba21c2ddb00

Kommentare können überall in Anfragezeichenfolgen eingebettet werden und werden durch einen Punkt (.) unmittelbar nach dem Befehlstrennzeichen (&) identifiziert. Der Kommentar wird beim nächsten Auftreten eines (nicht kodierten) Befehlstrennzeichens beendet. Mit dieser Funktion können Sie der Anfrage Informationen hinzufügen, die nicht für die Bildbereitstellung vorgesehen sind, z. B. Zeitstempel und Datenbank-IDs.

Verwandte Themen section-d0b836568c31454b8dbeb136e6bbe0f0

Datentypen, HTTP/1.1 Spezifikation

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