缩略图截取/网站预览图
接口地址:https://scan.ogonetboke.top/take
请求方式:Get
返回格式:Image
请求参数
名称 | 必填 | 类型 | 描述 |
---|---|---|---|
url | 是 | 字符串 | 要截屏的页面的绝对 URL |
format | 否 | 字符串 | 图像文件格式。支持的类型为 png 或 jpeg。默认值为 png。 |
quality | 否 | 整数 | 图像的质量,介于 1-100 之间。不适用于 png 图像。 |
full | 否 | 整数 | 如果为 true,则截取完整可滚动页面的屏幕截图。默认值为 false。 |
viewport-width | 否 | 整数 | 截屏时视口的宽度(以像素为单位)。使用较低的值(如 460)有助于模拟页面在移动设备上的外观。默认值为 800。 |
viewport-height | 否 | 整数 | 截屏时视口的高度(以像素为单位)。默认值为 600。 |
capture-beyond-viewport | 否 | 布尔 (int) | 隐藏默认的白色网页背景以捕获透明的屏幕截图,仅在 时有效。默认值为 0。formatpng |
cookies | 否 | JSON | 包含 cookie 对象的列表,例如 [{“name”:“foo”,“value”:“bar”,“domain”:“.example.com”}] |
navigation-timeout-ms | 否 | 整数 | 最大导航时间(以毫秒为单位),默认为 30 秒,通过 0 以禁用超时。 |
fail-on-timeout | 否 | 布尔 (int) | 如果设置为 false,我们将在达到超时时截取屏幕截图,而不是请求失败。默认值为 false。 |
wait-for-selector-timeout-ms | 否 | 整数 | 最长等待时间(以毫秒为单位)。传递 0 以禁用超时。默认值为 30 秒。示例:“5000”。 |
wait-for-xpath | 否 | 字符串 | 等待 xpath 出现在页中。示例: '//*[@id=“my-element”]/div'。 |
delay-ms | 否 | 整数 | 如果设置,我们将在页面加载事件后等待指定的秒数,然后再截取屏幕截图。 |
width | 否 | 整数 | 如果生成的图像宽度大于提供的值,则图像的大小将按比例调整为提供的宽度。此操作在最大高度检查之前运行。默认值为 0(不调整大小)。 |
max-height | 否 | 整数 | 如果生成的图像高度大于提供的值,则图像的高度将被裁剪为提供的值。默认值为 0(不裁剪)。 |
ttl | 否 | 整数 | 如果上次缓存的屏幕截图制作时间少于提供的秒数,则将返回缓存的图像,否则将缓存图像以供将来使用。 |
element | 否 | 字符串 | 查询元素的选择器以截屏。示例:“Body > div” |
scroll-page-to-bottom-size | 否 | 整数 | (滚动页面到底部)每个步骤上要滚动的像素数(默认值:250)。 |
device-scale-factor | 否 | 整数 | 画面质量。 |
返回参数