POST /screenshot

📸 单次截图端点。

📁 源码：pkg/api/screenshot.go

Handler

符号	源码	说明
HandleScreenshot	L19	POST /screenshot
HandleGetScreenshot	L77	GET /screenshot/:id
HandleListScreenshots	L319	GET /screenshots
createRunnerOptions	L125	请求→Options
ensureProtocol	L296	补协议

流程

请求状态流转

下图展示单次截图请求在 Handler 内部的状态机：从解析请求、生成 Options、调用截图、到落盘返回，以及各异常分支（参数错误、超时、内部错误）的出口。

请求示例

curl 调用示例

curl -X POST http://localhost:8080/screenshot \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","fullPage":true,"format":"png"}'

Authorization: Bearer <key> 与 X-API-Key: <key> 两种头都接受。

取回

• GET /screenshot/:id：取单张截图（图片或元信息）
• GET /screenshots：列出已存截图（ScreenshotInfo）

字段

请求体字段见 请求类型，响应见 响应格式。

下一步

• 请求类型
• 响应格式
• POST /batch
• CLI api