Image access
Public image delivery, subject to hotlink protection
计公开访问活跃度。带 w / format 参数时按需处理(宽度与格式须在后台允许的档位内);
format 缺省或为 auto 时按 Accept 协商,浏览器支持且档位允许则输出 WebP。
访问模式为 redirect 且有允许直链的渠道时 302 到渠道公开地址;处理失败降级输出原图并 Cache-Control: no-store。
已到期、尚待清理回收的图返回 404。参数非法(400)的请求不计访问。
id*string图片短 ID
w?integer目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放
format?string目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商
If-None-Match?string与上次响应的 ETag 一致时返回 304
图片字节(HEAD 只有响应头),带强 ETag。短 ID 下内容不可变,缓存一年(immutable);对象键别名可被同键重传 改指,为 Cache-Control: public, no-cache,每次带 ETag 确认、未变即 304。同一 URL 的输出格式随 Accept 协商时(未显式指定 format),原图与衍生图响应都带 Vary: Accept;处理失败降级输出原图时为 Cache-Control: no-store
image/*curl -X GET 'http://localhost:8721/i/string'与 GET 同一处理,只返回响应头,不计访问。输出原图时不打开渠道对象;需要按需处理时与 GET 一样取或生成衍生图 (缓存未命中即读原图处理),响应头与 GET 相同。
id*string图片短 ID
w?integer目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放
format?string目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商
If-None-Match?string与上次响应的 ETag 一致时返回 304
图片字节(HEAD 只有响应头),带强 ETag。短 ID 下内容不可变,缓存一年(immutable);对象键别名可被同键重传 改指,为 Cache-Control: public, no-cache,每次带 ETag 确认、未变即 304。同一 URL 的输出格式随 Accept 协商时(未显式指定 format),原图与衍生图响应都带 Vary: Accept;处理失败降级输出原图时为 Cache-Control: no-store
image/*curl -X HEAD 'http://localhost:8721/i/string'S3 协议面上传时客户端自取的对象键是访问别名;解析到短 ID 后与 /i/{id} 同一管线。对象键可含斜杠。 同键重传会让别名改指新图,故响应为 Cache-Control: public, no-cache,缓存方每次带 ETag 确认。
user_id*string归属用户 id;对象键只在用户内唯一
object_key*string客户端自取的对象键
w?integer目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放
format?string目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商
If-None-Match?string与上次响应的 ETag 一致时返回 304
图片字节(HEAD 只有响应头),带强 ETag。短 ID 下内容不可变,缓存一年(immutable);对象键别名可被同键重传 改指,为 Cache-Control: public, no-cache,每次带 ETag 确认、未变即 304。同一 URL 的输出格式随 Accept 协商时(未显式指定 format),原图与衍生图响应都带 Vary: Accept;处理失败降级输出原图时为 Cache-Control: no-store
image/*curl -X GET 'http://localhost:8721/o/string/string'与 GET 同一处理,只返回响应头,不计访问。输出原图时不打开渠道对象;需要按需处理时与 GET 一样取或生成衍生图 (缓存未命中即读原图处理),响应头与 GET 相同。
user_id*string归属用户 id;对象键只在用户内唯一
object_key*string客户端自取的对象键
w?integer目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放
format?string目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商
If-None-Match?string与上次响应的 ETag 一致时返回 304
图片字节(HEAD 只有响应头),带强 ETag。短 ID 下内容不可变,缓存一年(immutable);对象键别名可被同键重传 改指,为 Cache-Control: public, no-cache,每次带 ETag 确认、未变即 304。同一 URL 的输出格式随 Accept 协商时(未显式指定 format),原图与衍生图响应都带 Vary: Accept;处理失败降级输出原图时为 Cache-Control: no-store
image/*curl -X HEAD 'http://localhost:8721/o/string/string'