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