POST公开旧版图片截图Markdown迁移vv1

网页快照(旧版)

旧 ScreenShot 完整迁移:url 模式用真实第三方截图上游(image.thum.io)截网页,markdown/html 模式本地排版出图,支持 cache 回读。

/api/ScreenShot
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

旧 ScreenShot 完整迁移:url 模式用真实第三方截图上游(image.thum.io)截网页,markdown/html 模式本地排版出图,支持 cache 回读。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string旧路径参数:method
1stringcache 模式:缓存键(md5)
2stringcache 模式:子目录 markdown/html
urlstringurl 模式:要截图的网页
clipstring旧参数:裁剪选择器(上游不支持)
fullunion真值时截整页
htmlstringhtml 模式:HTML 片段
waitunion截图前等待秒数(映射上游 wait/N)
cacheunion真值时强制刷新缓存
themestringmarkdown/html:light | dark | auto(缺省)
bottomunion旧参数:滚到底部(上游不支持)
devicestringpc(缺省)| mobile
formatstring旧参数:png/jpeg(上游固定返回 PNG)
methodstringurl(缺省)| markdown | html | cache
cookiesstring旧参数:cookie(上游不支持)
headersstring旧参数:自定义请求头(上游不支持)
qualityunion旧参数:质量(上游不支持)
timeoutunion旧参数:超时秒数(上游不支持)
markdownstringmarkdown 模式:Markdown 内容
selectorstring旧参数:等待选择器(上游不支持)
viewportunion

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "url": "https://example.com",
  "full": 1
}

返回示例

response.json
{
  "code": 1,
  "message": {
    "base64": "<PNG base64>",
    "contentType": "image/png"
  }
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →