介绍
网页截屏大师使用真正的Chrome浏览器捕捉像素完美的屏幕截图,我们的核心服务托管在阿里云与腾讯云之上,API天然分布式、高可用。
起步
您可以使用 GET
或者 POST
向下面的入口发起一个网页截屏请求。
https://www.screenshotmaster.com/api/v1/screenshot
例子
如果要获取百度首页的图片 您可以将 baidu.com 添加到 url
参数中以发起请求。
https://www.screenshotmaster.com/api/v1/screenshot?url=baidu.com
认证
添加 token
参数在您的API请求中以获得认证。
https://www.screenshotmaster.com/api/v1/screenshot?
url=baidu.com
&token=YOUR_API_TOKEN
参数
以下是您可以在请求中添加的所有参数。
需要注意的是在发起 GET
请求时您务必将所有参数进行URL编码
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
token | string | '' | 您的API token |
url | string | '' | 需要截图的URL |
width | int | 1280 | 浏览器宽度 单位是像素 |
height | int | 800 | 浏览器高度 单位是像素 |
full_page | integer | 0 | 如果传1 则会进行网页长截图 |
browser_border | integer | 0 | 如果传1 则会使用内置浏览器边框进行图片渲染 |
color | string | E9D460 | 使用内置浏览器边框进行图片渲染时可以制定背景颜色 |
fresh | integer | 0 | 如果传1 则会重新进行截图 (而不是使用缓存的截图) |
output | string | 'image' | 您可以选择使用 json 作为输出格式, 或者选择image 则会输出原生图片格式 |
delay | int | 500 | 在截屏之前需要等待多少毫秒。 |
device | string | 'pc' | 使用的设备 pc表示桌面设备 mobile表示手机设备 table表示平板设备 |
cookies | string | '' | 要在浏览器中设置的cookie。如果发送多个cookie,请使用; to分割他们。例子: cookie1=myValue;cookie2=myOtherValue |
zone | string | '' | 区域 默认是国内线路 对国内网站进行截图推荐使用 若要对国际站点进行截图 可以传入 hk 则会效果更佳 |
错误
如果请求的HTTP状态代码返回4xx
或者 5xx
此时返回的数据将会带有一个msg
字段表示错误原因。
下面是当使用了错误token
时返回的例子。
{
"code": 422,
"data": [
],
"msg": "token不正确"
}
参考资料
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。