什么是網(wǎng)頁(yè)截圖的browshot?

什么是網(wǎng)頁(yè)截圖的browshot接口？

網(wǎng)頁(yè)截圖的browshot有哪些核心功能？

網(wǎng)頁(yè)截圖的browshot的核心優(yōu)勢(shì)是什么？

自動(dòng) S3 上傳 只需調(diào)用一次 API，即可將截圖直接上傳到 S3！	30 多種瀏覽器 iOS、Android、iPhone、Nexus、iPad、PC 等。 無(wú)論您需要什么，我們都有。	現(xiàn)收現(xiàn)付的低廉價(jià)格 無(wú)需支付高昂的月租費(fèi)，只需按需付費(fèi)。

在哪些場(chǎng)景會(huì)用到網(wǎng)頁(yè)截圖的browshot？

截圖 API

您可以申請(qǐng)?zhí)囟▽?shí)例的截圖，查詢其狀態(tài)并下載截圖和/或縮略圖。

/api/v1/screenshot/create

私人和共享實(shí)例的截圖請(qǐng)求需要正余額。

要求

所需參數(shù)：

• url：要截圖的頁(yè)面的 URL

• instance_id：要使用的實(shí)例 ID

常用參數(shù)：

• size：截圖尺寸："屏幕"（默認(rèn)）或 "頁(yè)面

• cache：如果截圖是在<cache_value> 秒內(nèi)完成的，則使用之前的截圖（同一 URL、同一實(shí)例）。默認(rèn)值為 24 小時(shí)。如果需要新截圖，請(qǐng)指定cache=0。

• delay=0 -120（默認(rèn)值：5）：頁(yè)面加載后等待的秒數(shù)。用于讓 JavaScript 運(yùn)行更長(zhǎng)時(shí)間后再截屏。使用delay=0可以更快地截圖。

• screen_width(1-5000)：瀏覽器窗口的寬度。僅適用于桌面瀏覽器。

• screen_height（1-10000）：瀏覽器窗口的高度。僅適用于桌面瀏覽器。(注意：整頁(yè)截圖的高度可達(dá) 15000px）。

可選參數(shù)：

• hide_popups：隱藏頁(yè)面上的彈出窗口（廣告、cookie 警告等）。

• 黑暗：在黑暗模式下運(yùn)行瀏覽器 - 僅適用于 Chrome 瀏覽器和手機(jī)

• strict_ssl（默認(rèn)值：0）：?jiǎn)⒂眠^(guò)期證書(shū)檢測(cè)功能，阻止混合內(nèi)容 - 僅適用于 Chrome 瀏覽器和移動(dòng)設(shè)備

• 推薦人（僅限付費(fèi)截圖）：使用自定義推薦人（請(qǐng)參閱 "自定義 POST 數(shù)據(jù)"、"推薦人和 Cookie"）。

• post_data（僅限付費(fèi)截圖）：發(fā)送帶有 post_data 的 POST 請(qǐng)求，用于填寫(xiě)表格（請(qǐng)參閱自定義 POST 數(shù)據(jù)、推薦人和 Cookie）。

• cookie（僅限付費(fèi)截圖）：為請(qǐng)求的 URL 設(shè)置 Cookie（請(qǐng)參閱自定義 POST 數(shù)據(jù)、推薦人和 Cookie）Cookie 應(yīng)使用 ；

• 腳本：頁(yè)面加載事件后要執(zhí)行的javascript 文件的 URL。

• script_inline：頁(yè)面加載事件后要執(zhí)行的 Javascript 內(nèi)容。

• details=0-3（默認(rèn)值：0）：截圖/信息提供的信息級(jí)別。

• html=0,1（默認(rèn)值：0）：保存渲染頁(yè)面的 HTML（可通過(guò) API 調(diào)用screenshot/html 獲?。?，并對(duì)頁(yè)面內(nèi)容進(jìn)行分類。每張截圖需花費(fèi) 1 個(gè)信用點(diǎn)。

• max_wait=1 -60（默認(rèn)值：0 = 禁用）：觸發(fā) PageLoad 事件前的最大等待秒數(shù)。注意，仍將使用延遲。

• headers：任何自定義 HTTP 標(biāo)頭。(不支持 Internet Explorer）

• target: CSS 選擇器。截圖頁(yè)面上由 CSS 選擇器標(biāo)識(shí)的元素

• priority=1-3（僅適用于私人實(shí)例）：為截圖指定優(yōu)先級(jí)

鉤子：
當(dāng)截圖完成或失敗時(shí)，您可以通過(guò)自己的 URL 接收通知。添加此參數(shù)：

• hook：您接收通知的 URL

當(dāng)截圖準(zhǔn)備就緒（狀態(tài)：完成或出錯(cuò)）時(shí)，將向您的 URL 發(fā)送 POST 請(qǐng)求。請(qǐng)求體包含 API 調(diào)用screenshot/info 返回的 JSON 數(shù)據(jù)。如果您的 URL 響應(yīng)時(shí)間過(guò)長(zhǎng)或未返回 20X 狀態(tài)代碼，請(qǐng)求最多可重試 2 次。

自動(dòng)化步驟
您可以創(chuàng)建與瀏覽器的達(dá)成交互，并截取多張屏幕截圖。有關(guān)詳細(xì)信息和示例，請(qǐng)參閱我們的博文。

• 步驟：JSON 格式的步驟列表。更多信息，請(qǐng)參閱我們的博文。

跟蹤器
您可以從網(wǎng)頁(yè)中提取信息，如搜索排名、價(jià)格、交貨日期、頁(yè)面標(biāo)題等。有關(guān)更多信息和示例，請(qǐng)參閱我們的博文。

• trackers （新增 1.28）：JSON 格式的跟蹤器列表。更多信息，請(qǐng)參閱我們的博文。

托管：
您可以使用這些附加參數(shù)將截圖和縮略圖自動(dòng)托管到 S3/Browshot/CDN：

• 托管：托管選項(xiàng)：S3 或 Browshot

• hosting_height（可選）：要托管的縮略圖的最大高度

• hosting_width（可選）：要托管的縮略圖的最大寬度

• hosting_scale（可選）：要托管的縮略圖的比例

• hosting_bucket（S3 需要）：用于上傳截圖或縮略圖的 S3 存儲(chǔ)桶

• hosting_file（可選，僅適用于 S3）：要使用的文件名

• hosting_headers（可選，僅適用于 S3）：要添加到 S3 對(duì)象的標(biāo)頭列表

• hosting_private（可選，僅適用于 S3）：將 ACL 設(shè)置為 "bucket-owner-full-control"，而不是 "public-read"。

如果截圖成功，縮略圖或截圖將自動(dòng)托管，無(wú)需調(diào)用screenshot/host。

公共和共享實(shí)例的優(yōu)先級(jí)是自動(dòng)分配的：1 代表最高，3 代表最低。處于處理狀態(tài)的截圖較少的賬戶優(yōu)先。已處理截圖的比例約為 4 個(gè)優(yōu)先級(jí) 1、2 個(gè)優(yōu)先級(jí) 2 和 1 個(gè)優(yōu)先級(jí) 3（將來(lái)可能會(huì)改變）。

重要：請(qǐng)記住，每月只能截取 100 張免費(fèi)截圖。要使用高級(jí)實(shí)例，請(qǐng)使用instance_id=65。

實(shí)例

Response:

截圖 API

您可以申請(qǐng)?zhí)囟▽?shí)例的截圖，查詢其狀態(tài)并下載截圖和/或縮略圖。

/api/v1/screenshot/create

私人和共享實(shí)例的截圖請(qǐng)求需要正余額。

要求

所需參數(shù)：

• url：要截圖的頁(yè)面的 URL

• instance_id：要使用的實(shí)例 ID

常用參數(shù)：

• size：截圖尺寸："屏幕"（默認(rèn)）或 "頁(yè)面

• cache：如果截圖是在<cache_value> 秒內(nèi)完成的，則使用之前的截圖（同一 URL、同一實(shí)例）。默認(rèn)值為 24 小時(shí)。如果需要新截圖，請(qǐng)指定cache=0。

• delay=0 -120（默認(rèn)值：5）：頁(yè)面加載后等待的秒數(shù)。用于讓 JavaScript 運(yùn)行更長(zhǎng)時(shí)間后再截屏。使用delay=0可以更快地截圖。

• screen_width(1-5000)：瀏覽器窗口的寬度。僅適用于桌面瀏覽器。

• screen_height（1-10000）：瀏覽器窗口的高度。僅適用于桌面瀏覽器。(注意：整頁(yè)截圖的高度可達(dá) 15000px）。

可選參數(shù)：

• hide_popups：隱藏頁(yè)面上的彈出窗口（廣告、cookie 警告等）。

• 黑暗：在黑暗模式下運(yùn)行瀏覽器 - 僅適用于 Chrome 瀏覽器和手機(jī)

• strict_ssl（默認(rèn)值：0）：?jiǎn)⒂眠^(guò)期證書(shū)檢測(cè)功能，阻止混合內(nèi)容 - 僅適用于 Chrome 瀏覽器和移動(dòng)設(shè)備

• 推薦人（僅限付費(fèi)截圖）：使用自定義推薦人（請(qǐng)參閱 "自定義 POST 數(shù)據(jù)"、"推薦人和 Cookie"）。

• post_data（僅限付費(fèi)截圖）：發(fā)送帶有 post_data 的 POST 請(qǐng)求，用于填寫(xiě)表格（請(qǐng)參閱自定義 POST 數(shù)據(jù)、推薦人和 Cookie）。

• cookie（僅限付費(fèi)截圖）：為請(qǐng)求的 URL 設(shè)置 Cookie（請(qǐng)參閱自定義 POST 數(shù)據(jù)、推薦人和 Cookie）Cookie 應(yīng)使用 ；

• 腳本：頁(yè)面加載事件后要執(zhí)行的javascript 文件的 URL。

• script_inline：頁(yè)面加載事件后要執(zhí)行的 Javascript 內(nèi)容。

• details=0-3（默認(rèn)值：0）：截圖/信息提供的信息級(jí)別。

• html=0,1（默認(rèn)值：0）：保存渲染頁(yè)面的 HTML（可通過(guò) API 調(diào)用screenshot/html 獲取），并對(duì)頁(yè)面內(nèi)容進(jìn)行分類。每張截圖需花費(fèi) 1 個(gè)信用點(diǎn)。

• max_wait=1 -60（默認(rèn)值：0 = 禁用）：觸發(fā) PageLoad 事件前的最大等待秒數(shù)。注意，仍將使用延遲。

• headers：任何自定義 HTTP 標(biāo)頭。(不支持 Internet Explorer）

• target: CSS 選擇器。截圖頁(yè)面上由 CSS 選擇器標(biāo)識(shí)的元素

• priority=1-3（僅適用于私人實(shí)例）：為截圖指定優(yōu)先級(jí)

鉤子：
當(dāng)截圖完成或失敗時(shí)，您可以通過(guò)自己的 URL 接收通知。添加此參數(shù)：

• hook：您接收通知的 URL

當(dāng)截圖準(zhǔn)備就緒（狀態(tài)：完成或出錯(cuò)）時(shí)，將向您的 URL 發(fā)送 POST 請(qǐng)求。請(qǐng)求體包含 API 調(diào)用screenshot/info 返回的 JSON 數(shù)據(jù)。如果您的 URL 響應(yīng)時(shí)間過(guò)長(zhǎng)或未返回 20X 狀態(tài)代碼，請(qǐng)求最多可重試 2 次。

自動(dòng)化步驟
您可以創(chuàng)建與瀏覽器的達(dá)成交互，并截取多張屏幕截圖。有關(guān)詳細(xì)信息和示例，請(qǐng)參閱我們的博文。

• 步驟：JSON 格式的步驟列表。更多信息，請(qǐng)參閱我們的博文。

跟蹤器
您可以從網(wǎng)頁(yè)中提取信息，如搜索排名、價(jià)格、交貨日期、頁(yè)面標(biāo)題等。有關(guān)更多信息和示例，請(qǐng)參閱我們的博文。

• trackers （新增 1.28）：JSON 格式的跟蹤器列表。更多信息，請(qǐng)參閱我們的博文。

托管：
您可以使用這些附加參數(shù)將截圖和縮略圖自動(dòng)托管到 S3/Browshot/CDN：

• 托管：托管選項(xiàng)：S3 或 Browshot

• hosting_height（可選）：要托管的縮略圖的最大高度

• hosting_width（可選）：要托管的縮略圖的最大寬度

• hosting_scale（可選）：要托管的縮略圖的比例

• hosting_bucket（S3 需要）：用于上傳截圖或縮略圖的 S3 存儲(chǔ)桶

• hosting_file（可選，僅適用于 S3）：要使用的文件名

• hosting_headers（可選，僅適用于 S3）：要添加到 S3 對(duì)象的標(biāo)頭列表

• hosting_private（可選，僅適用于 S3）：將 ACL 設(shè)置為 "bucket-owner-full-control"，而不是 "public-read"。

如果截圖成功，縮略圖或截圖將自動(dòng)托管，無(wú)需調(diào)用screenshot/host。

公共和共享實(shí)例的優(yōu)先級(jí)是自動(dòng)分配的：1 代表最高，3 代表最低。處于處理狀態(tài)的截圖較少的賬戶優(yōu)先。已處理截圖的比例約為 4 個(gè)優(yōu)先級(jí) 1、2 個(gè)優(yōu)先級(jí) 2 和 1 個(gè)優(yōu)先級(jí) 3（將來(lái)可能會(huì)改變）。

重要：請(qǐng)記住，每月只能截取 100 張免費(fèi)截圖。要使用高級(jí)實(shí)例，請(qǐng)使用instance_id=65。

實(shí)例

Response: