RESTfulスクリーンショットAPIを使用してウェブサイトのスクリーンショットを撮る

GrabzItのREST APIを使用すると、RESTful技術を使用してURLまたはHTMLを完全にキャプチャできます。 始める前に、ユースケースに応じて以下の警告を注意深く読んでください。他のAPIソリューションのいずれかがより適している場合があります。

開始するには、下のフィルターから実行する操作を選択するだけで、使用可能なパラメーターが基本的な例とともに表示されます。

    https://api.grabz.it/services/convert?key=Sign in to view your Application Key&format=&url=https%3A%2F%2Fspacex.com%2F

    curl 
    -d key=Sign in to view your Application Key 
    -d format= 
    -d html=%3Ch1%3EConvert%20Me%21%3C%2Fh1%3E 
    https://api.grabz.it/services/convert    

その後、キャプチャは HTTP 応答で返されます。 このタイプのキャプチャでは、次の追加オプションも使用できます。これらは、必須としてマークされているものを除き、すべてオプションです。 API 機能をテストするときは、使用をお勧めします。 Postman プロセスを簡素化します。

• URL -キャプチャへのURL。
  • 必須
• HTML -変換するHTML。
  • 必須
  • HTMLを変換するときは、HTTP POSTを使用する必要があります。
• キー - きみの アプリケーションキー.
  • 必須
• 折り返し電話 -ハンドラGrabzItのURLは、作業が完了した後に呼び出す必要があります。
  • 各言語のドキュメントに従って、ハンドラーを作成する方法を確認してください ASP.NET, Java, Node.js, パール, PHP, Python や ルビー.
• カスタムID -キャプチャに関連付けることができるカスタム識別子。
  • これは、指定したコールバックURLとともに返されます。
• フォーマット -キャプチャの形式。
  • デフォルト：jpg
  • オプション：
    • bmp8
    • bmp16
    • bmp24
    • bmpファイル
    • csvファイル
    • GIF
    • HTML
    • JPG
    • JSON
    • PDFファイル
    • DOCX
    • PNG
    • SEO
    • ちょっとしたけんか
    • mp4
    • webp
    • XLSX
• address -HTMLコードを実行するURL。変換されるHTMLがCSSや画像などのリソースへの相対URLを使用する場合に役立ちます。
  • デフォルト：空
• background -trueの場合、Webページの背景をPDFに含める必要があります
  • デフォルト：1
  • オプション：
    • 0 = PDFドキュメントにWebページの背景を含めないことを示します
    • 1 = PDFドキュメントにWebページの背景を含める必要があることを示します
• background -trueの場合、Webページの背景画像をDOCXに含める必要があります
  • デフォルト：1
  • オプション：
    • 0 = DOCXドキュメントにWebページの背景画像を含めないことを示します
    • 1 = DOCXドキュメントにWebページの背景画像を含める必要があることを示します
• bwidth -ピクセル単位のブラウザの幅
  • 警告この機能は現在ベータ版であり、一貫した結果が得られない場合があります。
  • デフォルト：1366
  • 最大：10000
  • 自動幅：-1 （-1を渡すと、 ブラウザの幅 文書の幅と一致します）
• bheight -ピクセル単位のブラウザの高さ。
  • デフォルト：1170
  • 最大：10000
  • 全長：-1 （-1を渡すと、Webページ全体のスクリーンショットが取得されます）
• click -これは、HTML要素を指定します。 CSSセレクター クリックします。 クリックの効果を表示するには、遅延も必要になる場合があることを忘れないでください
  • 警告この機能は現在ベータ版であり、一貫した結果が得られない場合があります。
• country - 国 スクリーンショット/キャプチャを取得する必要があります。
  • デフォルト：現在の最速の場所
  • オプション：「SG」、「UK」、「US」
• coverurl -PDFの表紙として使用されるWebページのURL
  • デフォルト：空
• customwatermarkid -追加 カスタム watermark or 特別 watermark ファイルに
  • デフォルト：空
• delay -ミリ秒数 スクリーンショットを撮る前に待つ
  • デフォルト：0
  • 最大：30000
• デュレーション -変換するビデオの秒単位の長さ intアニメーションGIF。
  • デフォルト：パッケージの最大長
• デュレーション - 記録する Web ページの長さを秒単位で指定します。
  • デフォルト：10
  • 最大：30
• export - エクスポートURL キャプチャのエクスポート先も指定します。
• FPS - キャプチャする必要がある XNUMX 秒あたりのフレーム数。
  • デフォルト：10
  • 最小：0.2
  • 最大：60
• FPS - キャプチャする必要がある XNUMX 秒あたりのフレーム数。
  • デフォルト：1
  • 最小：0.2
  • 最大：10
• hd -trueの場合、画像 キャプチャは高解像度になります これにより、画像のサイズが2倍になります。
  • デフォルト：0
  • オプション：
    • 0 =高精細画像を作成
    • 1 =高精細画像を作成
• height -結果のサムネイルの高さ（ピクセル単位）
  • デフォルト：出力幅と出力高さの両方が指定されていないか0の場合、出力幅と高さは最終的な画像の幅と高さに一致します。出力幅が指定されている場合、出力高さは出力幅に比例します。
  • 最大：パッケージの最大高さ
  • 全高：-1 （-1を渡すと、サムネイルの高さが縮小されないことを意味します）
• height - 結果のドキュメントのカスタムの高さ mm単位
  • デフォルト： ページサイズ 高さ
  • 最小：15
• 高さ -結果のアニメーションGIFのピクセル単位の高さ。
  • デフォルト：120px
  • 最大：パッケージの最大高さ
  • 自動サイズ：-1 （-1を渡すと、 アニメーションGIFはスケーリングされます 幅に関連して、高さが自動サイズ調整されている場合、幅はできません）
• hide - CSSセレクター 非表示にするWebページ内の1つまたは複数のHTML要素のうち、複数のHTML要素を指定して、各セレクターをコンマで区切ります。
  • デフォルト：空
• includealltables -trueの場合、Webページ上のすべてのテーブルが抽出され、各テーブルが個別のスプレッドシートシートに表示されます。
  • XLSX形式でのみ利用可能
  • デフォルト：0
  • オプション：
    • 0 =すべてのテーブルが抽出されないことを示します
    • 1 =すべてのテーブルが抽出されることを示します
• includeheadernames -真のヘッダー名がテーブルに含まれる場合
  • デフォルト：1
  • オプション：
    • 0 =ヘッダー名がテーブルに含まれないことを示します
    • 1 =ヘッダー名がテーブルに含まれることを示します
• includeimages -trueの場合、Webページの画像をDOCXに含める必要があります
  • デフォルト：1
  • オプション：
    • 0 = DOCXドキュメントにWebページ画像が含まれないことを示します
    • 1 = DOCXドキュメントにWebページ画像が含まれることを示します
• includelinks -リンクをドキュメントに含める場合はtrue
  • デフォルト：1
  • オプション：
    • 0 =ドキュメントにリンクを含めないことを示します
    • 1 =ドキュメントにリンクを含める必要があることを示します
• includeoutline -真の場合 PDFブックマーク 含める必要があります
  • デフォルト：0
  • オプション：
    • 0 = PDFドキュメントにアウトラインが含まれないことを示します
    • 1 = PDFドキュメントにアウトラインが含まれることを示します
• mergeid -キャプチャのIDを追加します 新しいドキュメントの最初にマージされた
  • デフォルト：空
• mtop -ドキュメントページの上部に表示されるミリメートル単位のマージン
  • デフォルト：10
• mleft -ドキュメントページの左側に表示されるミリメートル単位のマージン
  • デフォルト：10
• mbottom -ドキュメントページの下部に表示されるミリメートル単位のマージン
  • デフォルト：10
• mright -PDF文書の右側に表示されるミリメートル単位のマージン
  • デフォルト：10
• media - PDFドキュメントのCSSメディアタイプ
  • デフォルト：Print
  • オプション：
    • 印刷物
    • 画面
• noads - 真であれば 広告は自動的に非表示になります.
  • デフォルト：0
  • オプション：
    • 0 =広告を表示
    • 1 =広告を非表示
• nonotify -すべての一般的に見つかったtrueの場合 Cookie通知は自動的に非表示にする必要があります.
  • デフォルト：0
  • オプション：
    • 0 = Cookie通知を表示する
    • 1 = Cookie通知を非表示
• orientation -ドキュメントの向き
  • デフォルト：ポートレート
  • オプション：
    • 肖像画
    • 風景
• pagesize -文書のページサイズ
  • デフォルト：A4
  • オプション：
    • A3
    • A4
    • A5
    • A6
    • B3
    • B4
    • B5
    • B6
    • リーガルポリシー
    • 手紙
• password - ドキュメントを保護するためのパスワード 　
  • デフォルト：空
• proxy - HTTPプロキシの詳細 ブラウザソフトウェアは、このキャプチャの作成に使用する必要があります
• post -送信する投稿パラメータ。
• quality - キャプチャの品質、JPGおよびWEBPのデフォルトの圧縮率は90％、GIFは85％です。 このパラメーターは、BMP、PNG、またはTIFF画像には影響しません。
  • 品質を下げると、ファイルサイズが小さくなり、ダウンロード時間が短縮されます。
  • デフォルト：-1
  • 最小：-1
  • 最大：100
• 繰り返す -アニメーションGIFをループする回数。
  • デフォルト：0
  • 連続ループ：0
  • ループしない: -1
• 逆 -trueの場合、アニメーションGIFのフレームが反転します
  • デフォルト：0
  • オプション：
    • 0 =アニメーションが尊重されないことを示します
    • 1 =アニメーションが反転されることを示します
• requestas -使用したいユーザーエージェントのタイプ
  • デフォルト：0
  • オプション：
    • 0 = Webサイトの標準バージョンが返されることを示します
    • 1 =は モバイル版 ウェブサイトの
    • 2 = Webサイトの検索エンジンビューを返す必要があることを示します
• スピード -アニメーションGIFの速度。
  • デフォルト：1
  • 最小：0.2
  • 最大：10
• start -変換するビデオの開始位置 intアニメーションGIF。
  • デフォルト：0秒
• start - ビデオの読み込み後の開始時間 (秒単位)。
  • デフォルト：0秒
• tabletoinclude -変換されるテーブルのインデックス。Webページ内のすべてのテーブルがWebページの上部から下部へと順序付けられていた
  • デフォルト：1
• target -このパラメーターは CSSセレクター ターニングされるターゲットWebページ上の唯一のHTML要素の intドキュメントでは、Webページの他のすべての部分は無視されます。 一致するHTML要素が複数ある場合は、最初の要素が選択されます。
  • デフォルト：空
• target -このパラメーターは CSSセレクター ターニングされるターゲットWebページ上の唯一のHTML要素の int画像では、ウェブページの他の部分はすべて無視されます。 一致するHTML要素が複数ある場合は、最初の要素が選択されます。
  • デフォルト：空
• target -テーブルの抽出に使用するWebページ内の唯一のHTML要素のID
  • デフォルト：空
• transparent -trueの場合 画像キャプチャは透明でなければなりません。 これは、pngおよびtiff画像とのみ互換性があります。
  • デフォルト：0
  • オプション：
    • 0 =不透明な画像を作成
    • 1 =透明な画像を作成
• templateid -追加 template ドキュメントのヘッダーとフッターを指定するID
  • デフォルト：空
• title -PDFドキュメントにタイトルを付けます
  • デフォルト：空
• waitfor -これは、HTML要素を指定します。 CSSセレクター。 要素が キャプチャが実行された状態。 一致するHTML要素が複数ある場合は、最初の要素が選択されます。 このパラメーターを使用すると、キャプチャが実行されるまで最大25秒待機します。
• width -結果のサムネイルの幅（ピクセル単位）
  • デフォルト：出力幅と出力高さの両方が指定されていないか0の場合、出力幅と高さは最終的な画像の幅と高さに一致します。出力高さが指定されている場合、出力幅は出力高さに比例します。
  • 最大：パッケージの最大幅
  • 全幅：-1 （-1を渡すと、サムネイルの幅は縮小されません）
• width - 結果のドキュメントのカスタム幅 mm単位
  • デフォルト： ページサイズ 幅
  • 最小：15
• 幅 -結果のアニメーションGIFの幅（ピクセル単位）。
  • デフォルト：180px
  • 最大：パッケージの最大幅
  • 自動サイズ：-1 （-1を渡すと、 アニメーションGIFはスケーリングされます 高さに関連して、幅が自動サイズ調整されている場合、高さはできません）

ユーザー詳細

この簡単な電話で、現在のアカウント パッケージと残りの許容量を取得します。

    https://api.grabz.it/services/user?key=Sign in to view your Application Key

エラー処理

API に対して行ったリクエストに何らかの問題がある場合は、エラーを説明する JSON オブジェクトが返されます。 これを判断する最善の方法は、処理する前に応答のコンテンツ タイプを確認することです。 application/json エラーが発生しました。 JSON で見つかったエラー コードは次のとおりです。 コードの標準リスト.

{
    "Result": false,
    "Code":"URL is missing",
    "Message":100
}