介紹
網頁截圖大師使用真正的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不正確"
}
參考資料
本作品採用《CC 協議》,轉載必須註明作者和本文連結