文档Dynamic Media图像服务和渲染API

图像服务HTTP协议基本语法 image-serving-http-protocol-basic-syntax

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
  • 用户

HTTP协议的基本语法如下：

请求
http://服务器/is/image[/对象][？修饰符]
服务器
服务器地址[：端口]
对象
Source对象说明符（图像路径或图像目录条目）。
修饰符
修饰符*[&修饰符]
修饰符
命令|{$宏$}|{。评论}
命令
{ cmdName|{$ var}[= value]
宏
命令宏的名称。
评论
注释字符串（被服务器忽略）。
cmdName
支持的命令或属性名称之一。
变量
自定义变量的名称。
值
命令或变量值。

server_address、cmdName、macro ​和​ var ​不区分大小写。 服务器保留所有其他字符串值的大小写。

value ​是命令特定的，可以由一个或多个用逗号分隔的值组成。 有关详细信息，请参阅各个命令的描述。

服务器标识符 section-926ae55ddba14b8d952147a5fd701e14

所有HTTP图像服务请求都需要/is/image根上下文。

HTTP解码 section-20922baccd804d2d986b44ce9a183a7d

图像服务首先从传入请求中提取​ object ​和​ modifiers。 然后将​ object ​分隔到单独进行HTTP解码的路径元素中。 modifiers ​字符串被分为​ command= value ​对，然后在命令特定的处理之前对​ value ​进行HTTP解码。

NOTE
除非在文档中另有说明，否则所有不安全字符都必须按照HTTP标准进行编码。 有关详细信息，请参阅HTTP规范。

注释 section-69ef0be0f17a418c87a0eba21c2ddb00

注释可以嵌入到请求字符串的任何位置，并且由紧跟命令分隔符(&)后面的句点(.)来标识。 该注释被下一个出现的（未编码的）命令分隔符终止。 此功能可用于向请求添加不供图像服务使用的信息，例如时间戳和数据库ID。

另请参阅 section-d0b836568c31454b8dbeb136e6bbe0f0

数据类型，HTTP/1.1规范

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