介绍
网页截屏巨匠应用真正的 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 不正确"
}
参考资料
1. 截屏巨匠 API 文档