接口参考

图片访问

公开的图片输出入口,受防盗链约束

按短 ID 输出图片

GET
/i/{id}

计公开访问活跃度。带 w / format 参数时按需处理(宽度与格式须在后台允许的档位内); format 缺省或为 auto 时按 Accept 协商,浏览器支持且档位允许则输出 WebP。 访问模式为 redirect 且有允许直链的渠道时 302 到渠道公开地址;处理失败降级输出原图并 Cache-Control: no-store。 已到期、尚待清理回收的图返回 404。参数非法(400)的请求不计访问。

Path Parameters

id*string

图片短 ID

Query Parameters

w?integer

目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放

format?string

目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商

Header Parameters

If-None-Match?string

与上次响应的 ETag 一致时返回 304

Response Body

图片字节(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'
Empty
HEAD
/i/{id}

与 GET 同一处理,只返回响应头,不计访问。输出原图时不打开渠道对象;需要按需处理时与 GET 一样取或生成衍生图 (缓存未命中即读原图处理),响应头与 GET 相同。

Path Parameters

id*string

图片短 ID

Query Parameters

w?integer

目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放

format?string

目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商

Header Parameters

If-None-Match?string

与上次响应的 ETag 一致时返回 304

Response Body

图片字节(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'
Empty
GET
/o/{user_id}/{object_key}

S3 协议面上传时客户端自取的对象键是访问别名;解析到短 ID 后与 /i/{id} 同一管线。对象键可含斜杠。 同键重传会让别名改指新图,故响应为 Cache-Control: public, no-cache,缓存方每次带 ETag 确认。

Path Parameters

user_id*string

归属用户 id;对象键只在用户内唯一

object_key*string

客户端自取的对象键

Query Parameters

w?integer

目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放

format?string

目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商

Header Parameters

If-None-Match?string

与上次响应的 ETag 一致时返回 304

Response Body

图片字节(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'
Empty
HEAD
/o/{user_id}/{object_key}

与 GET 同一处理,只返回响应头,不计访问。输出原图时不打开渠道对象;需要按需处理时与 GET 一样取或生成衍生图 (缓存未命中即读原图处理),响应头与 GET 相同。

Path Parameters

user_id*string

归属用户 id;对象键只在用户内唯一

object_key*string

客户端自取的对象键

Query Parameters

w?integer

目标宽度(像素),须在运营配置 process_widths 的档位内;缺省不缩放

format?string

目标格式,须在运营配置 process_formats 内;缺省或 auto 按 Accept 协商

Header Parameters

If-None-Match?string

与上次响应的 ETag 一致时返回 304

Response Body

图片字节(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'
Empty