Dokumentation Dynamic Media Image Serving and Rendering API

Grundlegende Syntax des HTTP-Protokolls "Image Rendering" image-rendering-http-protocol-basic-syntax

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

Themen:

Erstellt für:

Entwickler
Benutzende

In diesem Abschnitt wird die grundlegende Syntax des Dynamic Media Image Rendering-HTTP-Protokolls beschrieben.

Element

Definition

request

http:// server/ir/render[/ vignette ] [ ? modifiers ]

server

server_address [ : port ]

Vignette

Vignettenspezifikator (relativer Dateipfad oder Vignettenkatalog).

modifiers

modifier *[ & modifier ]

modifier

command | { $ macro $ } | { . comment }

Befehl

{ cmdName | { $ var } [ = value ]

macro

Name eines Befehlsmakros.

comment

Kommentar-Zeichenfolge (vom Server ignoriert).

cmdName

Name eines Befehls oder Attributs.

var

Name einer benutzerdefinierten Variablen.

value

Befehls- oder Variablenwert.

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

Server-ID

Der Stammkontext "/ir/render" ist für alle HTTP-Anforderungen an das Bild-Rendering erforderlich.

Kommentare

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

HTTP-Decodierung

Beim Rendern von Bildern werden zunächst object und modifiers aus der eingehenden Anforderung extrahiert. Der 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.

recommendation-more-help

a26166cd-f2f4-45ce-996d-96a0f0d6cf49