查看原始 JSON
{
"type": "object",
"required": [],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"page": {
"enum": [
"login",
"signup",
"blog",
"careers",
"pricing",
"terms",
"privacy",
"contact"
],
"type": "string",
"description": "选择 pricing、contact 等指定页面类型,只能与 domain 一起使用。供应商会查找域名内的匹配页面。"
},
"domain": {
"type": "string",
"minLength": 3,
"description": "要截图的域名,例如 example.com。不能同时提供 directUrl。"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "供应商支持的两位 ISO 3166-1 alpha-2 国家代码,例如 us、gb 或 de。"
},
"maxAgeMs": {
"type": "integer",
"maximum": 2592000000,
"minimum": 0,
"description": "可复用缓存的最大年龄,单位毫秒。默认一天,最多 30 天;设为 0 请求重新获取。"
},
"directUrl": {
"type": "string",
"format": "uri",
"description": "要截图的准确网页绝对地址。提供后直接使用该地址,不能同时提供 domain。"
},
"timeoutMS": {
"type": "integer",
"maximum": 300000,
"minimum": 1000,
"description": "供应商超时上限,单位毫秒,最大 300000。应短于该端点的 requestTimeoutMs,避免平台先超时。"
},
"waitForMs": {
"type": "integer",
"maximum": 30000,
"minimum": 0,
"description": "页面加载后额外等待的毫秒数,范围 0–30000,可用于等待动态内容。"
},
"colorScheme": {
"enum": [
"light",
"dark"
],
"type": "string",
"description": "让支持明暗外观的网站采用 light 或 dark 浏览器配色。"
},
"scrollOffset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "从指定垂直像素位置截取视口画面,优先于 fullScreenshot。"
},
"fullScreenshot": {
"type": "boolean",
"description": "是否截取整页。默认 false,只截取视口。"
},
"handleCookiePopup": {
"type": "boolean",
"description": "是否尝试关闭 Cookie 或同意弹窗。默认 false。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}