screenshot.png
介紹
網(wǎng)頁截屏大師使用真正的Chrome瀏覽器捕捉像素完美的屏幕截圖训措,我們的核心服務(wù)托管在阿里云與騰訊云之上,API天然分布式光羞、高可用绩鸣。
起步
您可以使用 GET
或者 POST
向下面的入口發(fā)起一個網(wǎng)頁截屏請求。
https://www.screenshotmaster.com/api/v1/screenshot
例子
如果要獲取百度首頁的圖片 您可以將 baidu.com 添加到 url
參數(shù)中以發(fā)起請求纱兑。
https://www.screenshotmaster.com/api/v1/screenshot?url=baidu.com
認(rèn)證
添加 token
參數(shù)在您的API請求中以獲得認(rèn)證呀闻。
https://www.screenshotmaster.com/api/v1/screenshot?
url=baidu.com
&token=YOUR_API_TOKEN
參數(shù)
以下是您可以在請求中添加的所有參數(shù)。
需要注意的是在發(fā)起 GET
請求時您務(wù)必將所有參數(shù)進行URL編碼
參數(shù) | 類型 | 默認(rèn)值 | 描述 |
---|---|---|---|
token | string | '' | 您的API token |
url | string | '' | 需要截圖的URL |
width | int | 1280 | 瀏覽器寬度 單位是像素 |
height | int | 800 | 瀏覽器高度 單位是像素 |
full_page | integer | 0 | 如果傳1 則會進行網(wǎng)頁長截圖 |
browser_border | integer | 0 | 如果傳1 則會使用內(nèi)置瀏覽器邊框進行圖片渲染 |
color | string | E9D460 | 使用內(nèi)置瀏覽器邊框進行圖片渲染時可以制定背景顏色 |
fresh | integer | 0 | 如果傳1 則會重新進行截圖 (而不是使用緩存的截圖) |
output | string | 'image' | 您可以選擇使用 json 作為輸出格式, 或者選擇image 則會輸出原生圖片格式 |
delay | int | 500 | 在截屏之前需要等待多少毫秒潜慎。 |
device | string | 'pc' | 使用的設(shè)備 pc表示桌面設(shè)備 mobile表示手機設(shè)備 table表示平板設(shè)備 |
cookies | string | '' | 要在瀏覽器中設(shè)置的cookie捡多。如果發(fā)送多個cookie,請使用; to分割他們铐炫。例子: cookie1=myValue;cookie2=myOtherValue
|
zone | string | '' | 區(qū)域 默認(rèn)是國內(nèi)線路 對國內(nèi)網(wǎng)站進行截圖推薦使用 若要對國際站點進行截圖 可以傳入 hk 則會效果更佳 |
錯誤
如果請求的HTTP狀態(tài)代碼返回4xx
或者 5xx
此時返回的數(shù)據(jù)將會帶有一個msg
字段表示錯誤原因垒手。
下面是當(dāng)使用了錯誤token
時返回的例子。
{
"code": 422,
"data": [
],
"msg": "token不正確"
}
參考資料