Tools zum Erfassen und Konvertieren des Webs

Machen Sie Website-Screenshots mit unserer RESTful Screenshot-APIREST API

Mit der REST-API von GrabzIt können Sie URLs oder HTML-Code vollständig mithilfe von RESTful-Techniken erfassen. Bevor Sie beginnen, lesen Sie bitte die folgenden Vorsichtsmaßnahmen sorgfältig durch. Je nach Anwendungsfall ist eine unserer anderen API-Lösungen möglicherweise besser geeignet.

  • - Einige Funktionen wie das Zusammenführen und Verschlüsseln von Captures sind über diese REST-API nicht verfügbar. Um diese Funktionen nutzen zu können, müssen Sie eine andere verwenden API-Bibliothek
  • - Verwenden Sie diese API nicht auf der Clientseite, da sonst Ihr Anwendungsschlüssel verfügbar gemacht wird! Verwenden Sie stattdessen die JavaScript-API

Wählen Sie zunächst aus dem folgenden Filter aus, was Sie tun möchten, und die verfügbaren Parameter werden zusammen mit einem einfachen Beispiel angezeigt.

Wenn Sie Anfragen stellen, stellen Sie bitte sicher aller Parameterwerte sind URL-codiert.

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

Bei der Konvertierung von HTML müssen alle Parameter sein im Anfragetext gepostet als Schlüssel-Wert-Paare. Stellen Sie sicher, dass alle Parameterwerte URL-codiert sind.

    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.ashx    

Die folgenden zusätzlichen Optionen sind für diese Art der Erfassung verfügbar. Alle Optionen sind optional, mit Ausnahme der als erforderlich gekennzeichneten. Beim Testen der API-Funktionalität empfehlen wir die Verwendung Postman um den Prozess zu vereinfachen.

  • URL - die URL zum Capture.
    • Erforderlich
  • html - das HTML zum konvertieren.
    • Erforderlich
    • Bei der Konvertierung von HTML müssen Sie einen HTTP-POST verwenden.
  • Schlüssel - Ihre Anwendungsschlüssel.
    • Erforderlich
  • callback - Die URL des Handlers GrabzIt sollte nach Abschluss seiner Arbeit aufrufen.
  • customid - die benutzerdefinierte Kennung, die Sie der Erfassung zuordnen können.
    • Dies wird mit jeder von Ihnen angegebenen Rückruf-URL zurückgegeben.
  • Format - Das Format, in dem die Aufnahme erfolgen soll.
    • Voreinstellung: jpg
    • Zubehör:
      • bmp8
      • bmp16
      • bmp24
      • bmp
      • csv
        • CSV-Dateien werden automatisch heruntergeladen.
      • gif
      • html
        • HTML-Dateien werden automatisch heruntergeladen.
      • jpg
      • JSON
        • JSON-Dateien werden automatisch heruntergeladen.
      • pdf
        • PDF-Dateien werden automatisch heruntergeladen.
      • docx
        • DOCX-Dateien werden automatisch heruntergeladen.
      • png
      • tiff
      • webp
      • XLSX
        • XLSX-Dateien werden automatisch heruntergeladen.
  • address - Die URL, unter der der HTML-Code ausgeführt werden soll. Kann hilfreich sein, wenn für die zu konvertierende HTML relative URLs zu Ressourcen wie CSS und Bildern verwendet werden.
    • Voreinstellung: leer
  • background - Wenn dies zutrifft, sollte der Hintergrund der Webseite in das PDF aufgenommen werden
    • Standard: 1
    • Zubehör:
      • 0 = gibt an, dass das PDF-Dokument den Hintergrund der Webseite nicht enthalten soll
      • 1 = gibt an, dass das PDF-Dokument den Hintergrund der Webseite enthalten soll
  • background - Wenn dies zutrifft, sollten die Hintergrundbilder der Webseite in die DOCX aufgenommen werden
    • Standard: 1
    • Zubehör:
      • 0 = gibt an, dass das DOCX-Dokument keine Hintergrundbilder für Webseiten enthalten soll
      • 1 = gibt an, dass das DOCX-Dokument die Hintergrundbilder der Webseite enthalten soll
  • bwidth - die Breite des Browsers in Pixel
    • Warnung: Diese Funktion befindet sich derzeit in der Beta-Phase und liefert möglicherweise keine konsistenten Ergebnisse.
    • Standard: 1024
    • Maximum: 10000
    • Automatische Breite: -1 (Übergabe von -1 bedeutet, dass das Breite des Browsers entspricht der Breite des Dokuments)
  • bheight - die Höhe des Browsers in Pixel.
    • Standard: 768
    • Maximum: 10000
    • Volle Länge: -1 (Die Übergabe von -1 bedeutet, dass ein Screenshot der gesamten Webseite erstellt wird.)
  • country - das Land Der Screenshot / das Capture sollte von stammen.
    • Warnung: Diese Funktion befindet sich derzeit in der Beta-Phase und liefert möglicherweise keine konsistenten Ergebnisse.
    • Standard: Der aktuell schnellste Standort
    • Optionen: "SG", "UK", "US"
  • coverurl - Die URL einer Webseite, die als Deckblatt für das PDF verwendet werden soll
    • Voreinstellung: leer
  • customwatermarkid - füge hinzu ein Benutzerdefiniertes Wasserzeichen in die Datei
    • Voreinstellung: leer
  • delay - die Anzahl der Millisekunden bis Warten Sie, bevor Sie den Screenshot aufnehmen
    • Standard: 0
    • Maximum: 30000
  • Dauer - Die Länge des zu konvertierenden Videos in Sekunden into ein animiertes GIF.
    • Standard: maximale Länge für das Paket
  • export - der URL exportieren Hiermit wird festgelegt, wohin das Capture ebenfalls exportiert werden soll.
  • filename - Überschreiben Sie den Dateinamen der heruntergeladenen Datei
    • Nur gültig, wenn der Screenshot / das Capture heruntergeladen wird
    • Voreinstellung: leer
  • fps - Die Anzahl der Bilder pro Sekunde, die aus dem Video aufgenommen werden sollen.
    • Standard: 10
    • Minimum: 0.2
    • Maximum: 60
  • hd - Wenn das Bild wahr ist Die Aufnahme erfolgt in High Definition Dies verdoppelt die Größe der Bildabmessungen.
    • Standard: 0
    • Zubehör:
      • 0 = Erstellt ein hochauflösendes Bild
      • 1 = Erstellt ein hochauflösendes Bild
  • height - Die Höhe des resultierenden Thumbnails in Pixel
    • Standard: Das höchstmögliche Verhältnis der Browserhöhe, das in die maximale Höhe des Benutzerpakets passt
    • Maximum: Maximale Höhe für das Paket
    • Volle Höhe: -1 (Das Übergeben von -1 bedeutet, dass die Höhe des Thumbnails nicht verringert wird.)
  • height - der Benutzerdefinierte Höhe des resultierenden Dokuments in mm
  • Höhe - Die Höhe des resultierenden animierten GIF in Pixel.
    • Standard: 120px
    • Maximum: Maximale Höhe für das Paket
    • Automatische Größe: -1 (Übergabe von -1 bedeutet, dass die Höhe des animiertes GIF wird skaliert in Bezug auf die Breite, wenn die Höhe automatisch angepasst wird, kann die Breite nicht)
  • hide - der CSS-Selektoren Wenn Sie festlegen möchten, dass mehrere HTML-Elemente auf der Webseite ausgeblendet werden sollen, trennen Sie jeden Selektor durch ein Komma.
    • Voreinstellung: leer
  • includealltables - Wenn true, werden alle Tabellen auf der Webseite extrahiert, wobei jede Tabelle in einem separaten Arbeitsblatt angezeigt wird.
    • Nur im XLSX-Format verfügbar
    • Standard: 0
    • Zubehör:
      • 0 = gibt an, dass nicht alle Tabellen extrahiert werden
      • 1 = gibt an, dass alle Tabellen extrahiert werden
  • includeheadernames - ob echte Headernamen in die Tabelle aufgenommen werden
    • Standard: 1
    • Zubehör:
      • 0 = gibt an, dass die Headernamen nicht in die Tabelle aufgenommen werden
      • 1 = gibt an, dass die Headernamen in die Tabelle aufgenommen werden
  • includeimages - Wenn dies zutrifft, sollten die Bilder der Webseite in die DOCX aufgenommen werden
    • Standard: 1
    • Zubehör:
      • 0 = gibt an, dass das DOCX-Dokument keine Webseitenbilder enthält
      • 1 = gibt an, dass das DOCX-Dokument Webseitenbilder enthält
  • includelinks - true, wenn Links in das Dokument aufgenommen werden sollen
    • Standard: 1
    • Zubehör:
      • 0 = gibt an, dass das Dokument keine Links enthalten soll
      • 1 = gibt an, dass das Dokument Links enthalten soll
  • includeoutline - wahr wenn PDF Lesezeichen das sollte dabei sein
    • Standard: 0
    • Zubehör:
      • 0 = gibt an, dass das PDF-Dokument keine Gliederung enthält
      • 1 = gibt an, dass das PDF-Dokument eine Gliederung enthält
  • mergeid - Fügen Sie die ID eines Captures hinzu, das sein soll am Anfang des neuen Dokuments zusammengeführt
    • Voreinstellung: leer
  • mtop - Der Rand in Millimetern, der oben auf der Dokumentseite angezeigt werden soll
    • Standard: 10
  • mleft - Der Rand in Millimetern, der links auf der Dokumentseite angezeigt werden soll
    • Standard: 10
  • mbottom - der Rand in Millimetern, der am unteren Rand der Dokumentseite angezeigt werden soll
    • Standard: 10
  • mright - Der Rand in Millimetern, der rechts vom PDF-Dokument angezeigt werden soll
    • Standard: 10
  • media - der CSS-Medientyp des PDF-Dokuments
    • Voreinstellung: Print
    • Zubehör:
      • Drucken
      • Bildschirm
  • noads - Wenn wahr Anzeigen sollten automatisch ausgeblendet werden.
    • Standard: 0
    • Zubehör:
      • 0 = Werbung anzeigen
      • 1 = Werbung ausblenden
  • nonotify - Wenn wahr, alle häufig gefunden Cookie-Benachrichtigungen sollten automatisch ausgeblendet werden.
    • Standard: 0
    • Zubehör:
      • 0 = Cookie-Benachrichtigungen anzeigen
      • 1 = Cookie-Benachrichtigungen ausblenden
  • orientation - die Ausrichtung des Dokuments
    • Standardeinstellung: Porträt
    • Zubehör:
      • Porträt
      • Landschaft
  • pagesize - das Seitenformat des Dokuments
    • Voreinstellung: A4
    • Zubehör:
      • A3
      • A4
      • A5
      • A6
      • B3
      • B4
      • B5
      • B6
      • Legal
      • Brief
  • password - der Passwort, um das Dokument zu schützen mit
    • Voreinstellung: leer
  • proxy - die HTTP-Proxy-Details Die Browsersoftware sollte zur Erstellung dieses Captures verwendet werden
  • post - alle Post-Parameter, die Sie senden möchten.
  • quality - der Qualität der Aufnahme, JPG und WEBP haben eine Standardkomprimierung von 90% und GIF von 85%. Dieser Parameter hat keine Auswirkung auf BMP-, PNG- oder TIFF-Bilder.
    • Durch Verringern der Qualität wird die Dateigröße verringert und die Downloadzeit verkürzt.
    • Standardeinstellung: -1
    • Minimum: -1
    • Maximum: 100
  • wiederholen - Häufigkeit, mit der das animierte GIF wiederholt wird.
    • Standard: 0
    • Endlosschleife: 0
  • rückgängig machen - Wenn true, werden die Frames des animierten GIF umgekehrt
    • Standard: 0
    • Zubehör:
      • 0 = zeigt an, dass die Animation nicht erneut gewertet wird
      • 1 = zeigt an, dass die Animation umgekehrt wird
  • requestas - die Art des Benutzeragenten, den Sie verwenden möchten
    • Standard: 0
    • Zubehör:
      • 0 = gibt an, dass die Standardversion der Website zurückgegeben werden soll
      • 1 = gibt das an mobile Version einer Website sollte zurückgegeben werden
      • 2 = Gibt an, dass die Suchmaschinenansicht einer Website zurückgegeben werden soll
  • Geschwindigkeit - die Geschwindigkeit des animierten GIF.
    • Standard: 1
    • Minimum: 0.2
    • Maximum: 10
  • Anfang - Die Startposition des Videos, das konvertiert werden soll into ein animiertes GIF.
    • Voreinstellung: 0 Sekunden
  • tabletoinclude - Der Index der zu konvertierenden Tabelle, in dem alle Tabellen einer Webseite von oben nach unten angeordnet sind
    • Standard: 1
  • target - Dieser Parameter gibt das an CSS-Selektor des einzigen HTML-Elements auf der Zielwebseite, das gedreht werden soll into Ein Dokument, alle anderen Teile der Webseite werden ignoriert. Wenn mehrere übereinstimmende HTML-Elemente vorhanden sind, wird das erste ausgewählt.
    • Voreinstellung: leer
  • target - Dieser Parameter gibt das an CSS-Selektor der einzige HTML-Element auf der Zielwebseite, die gedreht werden soll into ein Bild, werden alle anderen Teile der Webseite ignoriert. Wenn mehrere übereinstimmende HTML-Elemente vorhanden sind, wird das erste ausgewählt.
    • Voreinstellung: leer
  • target - Die ID des einzigen HTML-Elements auf der Webseite, aus dem Tabellen extrahiert werden sollen
    • Voreinstellung: leer
  • transparent - Wenn das stimmt Die Bildaufnahme sollte transparent sein. Dies ist nur mit PNG- und TIFF-Bildern kompatibel.
    • Standard: 0
    • Zubehör:
      • 0 = Erstellt ein nicht transparentes Bild
      • 1 = Erstellt ein transparentes Bild
  • templateid - füge hinzu ein Vorlage ID, die die Kopf- und Fußzeile des Dokuments angibt
    • Voreinstellung: leer
  • title - Geben Sie dem PDF-Dokument einen Titel
    • Voreinstellung: leer
  • waitfor - Dies gibt das HTML-Element mit a an CSS-Selektor. Sobald das Element ist sichtbar wird das Capture ausgeführt. Wenn mehrere übereinstimmende HTML-Elemente vorhanden sind, wird das erste ausgewählt. Wenn dieser Parameter verwendet wird, wartet er maximal 25 Sekunden, bevor die Erfassung durchgeführt wird.
  • width - die Breite des resultierenden Thumbnails in Pixel
    • Standard: Das höchstmögliche Verhältnis der Browserbreite, das in die maximale Breite des Benutzerpakets passt
    • Maximum: Maximale Breite für das Paket
    • Volle Breite: -1 (Das Übergeben von -1 bedeutet, dass die Breite des Thumbnails nicht verringert wird.)
  • width - der benutzerdefinierte Breite des resultierenden Dokuments in mm
  • Breite - die Breite des resultierenden animierten GIF in Pixel.
    • Standard: 180px
    • Maximum: Maximale Breite für das Paket
    • Automatische Größe: -1 (Übergabe von -1 bedeutet, dass die Breite des animiertes GIF wird skaliert In Bezug auf die Höhe kann die Höhe nicht angepasst werden, wenn die Breite automatisch angepasst wird.