资源接口

上传资源

POST /v1/resource
Content-Type: multipart/form-data

请求参数

参数	位置	类型	必需	约束
file	multipart	binary	是	JPEG、PNG 或 WebP；受字节和像素限制

curl -X POST https://markify.example.com/v1/resource \
  -F 'file=@source.png'

成功响应

HTTP 201：

{
  "resourceToken": "<43-character-base64url-token>",
  "expiresIn": 3000,
  "mediaType": "image/png",
  "size": 184220,
  "width": 1920,
  "height": 1080,
  "status": "READY"
}

字段	类型	说明
resourceToken	string	临时资源唯一标识
expiresIn	integer	剩余有效秒数
mediaType	enum	image/jpeg、image/png、image/webp
size	integer	文件字节数
width	integer	图片宽度
height	integer	图片高度
status	enum	创建后为 READY

失败响应

• 400：缺少文件或 multipart 非法。
• 413：上传超过 MAX_RESOURCE_UPLOAD_BYTES。
• 422 INVALID_IMAGE_RESOURCE：内容不可读取、MIME 不一致或像素超限。
• 503 RESOURCE_SERVICE_UNAVAILABLE：API 无法访问资源服务。
• 507 RESOURCE_CAPACITY_EXCEEDED：资源总容量耗尽。

删除资源

DELETE /v1/resource/{resourceToken}

成功返回 204 No Content，同时关闭该资源关联的预览流。存在活动读取租约时，资源先进入 DELETE_PENDING，文件在租约归零后删除。

失败响应：

• 404 RESOURCE_NOT_FOUND
• 410 RESOURCE_EXPIRED
• 503 RESOURCE_SERVICE_UNAVAILABLE

Token 不是文件地址

客户端不能根据 token 拼接 Resource Service 内部 URL。资源内容只能通过公开业务接口参与预览和最终渲染。