image

介绍

网页截屏大师使用真正的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编码

参数类型默认值描述
tokenstring''您的API token
urlstring''需要截图的URL
widthint1280浏览器宽度 单位是像素
heightint800浏览器高度 单位是像素
full_pageinteger0如果传1 则会进行网页长截图
browser_borderinteger0如果传1 则会使用内置浏览器边框进行图片渲染
colorstringE9D460使用内置浏览器边框进行图片渲染时可以制定背景颜色
freshinteger0如果传1 则会重新进行截图 (而不是使用缓存的截图)
outputstring'image'您可以选择使用 json 作为输出格式, 或者选择image 则会输出原生图片格式
delayint500在截屏之前需要等待多少毫秒。
devicestring'pc'使用的设备 pc表示桌面设备 mobile表示手机设备 table表示平板设备
cookiesstring''要在浏览器中设置的cookie。如果发送多个cookie,请使用;to分割他们。例子: cookie1=myValue;cookie2=myOtherValue
zonestring''区域 默认是国内线路 对国内网站进行截图推荐使用 若要对国际站点进行截图 可以传入 hk则会效果更佳

错误

如果请求的HTTP状态代码返回4xx 或者 5xx 此时返回的数据将会带有一个msg字段表示错误原因。
下面是当使用了错误token时返回的例子。

{
   "code": 422,
   "data": [

   ],
   "msg": "token不正确"
}

参考资料

1.截屏大师API文档


xx19941215
2.3k 声望365 粉丝

// 刻意练习 每日精进