接口文档

所有 /v1 接口都需要 Authorization: Bearer bk_live_…。每个 Key 每分钟 20 次，并发上限 1，单次导航 20 秒超时。

鉴权

Authorization: Bearer bk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

接口

POST /v1/screenshot

截图，返回 PNG / JPEG 二进制

curl -X POST https://browser.sparkcn.xyz/v1/screenshot \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","fullPage":true,"width":1280,"height":800,"format":"png"}'

POST /v1/pdf

打印排版 PDF

curl -X POST https://browser.sparkcn.xyz/v1/pdf \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"A4","printBackground":true}'

POST /v1/content

渲染后 HTML + 纯文本，返回 JSON

curl -X POST https://browser.sparkcn.xyz/v1/content \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","waitUntil":"load"}'

健康检查

curl https://browser.sparkcn.xyz/api/health

错误码

状态码	code	含义
400	invalid_url / missing_url / invalid_option	参数不合法
401	unauthorized	API Key 缺失或失效
403	private_target	目标指向内网 / 环回地址
429	rate_limited	超过每分钟限额
502	render_failed	目标页面渲染失败或超时
503	queue_full	并发已满且排队超时