Machen Sie Website-Screenshots mit unserer RESTful Screenshot-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.

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.

    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    

Die Erfassung wird dann in der HTTP-Antwort zurückgegeben. Die folgenden zusätzlichen Optionen sind auch für diese Art der Erfassung verfügbar, die alle optional sind, 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.
  • Informationen zum Erstellen eines Handlers finden Sie in der Dokumentation zu den einzelnen Sprachen ASP.NET, Java, Node.js, Perl, PHP, Python funktioniert Ruby.
• benutzerdefinierte - 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
    • gif
    • html
    • jpg
    • JSON
    • pdf
    • docx
    • png
    • seo
    • tiff
    • webp
    • XLSX
• 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: 1366
  • 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: 1170
  • Maximum: 10000
  • Volle Länge: -1 (Die Übergabe von -1 bedeutet, dass ein Screenshot der gesamten Webseite erstellt wird.)
• click - Dies gibt das HTML-Element mit a an CSS-Selektor klicken. Denken Sie daran, dass auch eine Verzögerung erforderlich sein kann, um die Auswirkungen des Klicks anzuzeigen
  • Warnung: Diese Funktion befindet sich derzeit in der Beta-Phase und liefert möglicherweise keine konsistenten Ergebnisse.
• country - das Land Der Screenshot / das Capture sollte von stammen.
  • 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 Original watermark 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.
• 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: Wenn sowohl die Ausgabebreite als auch die Ausgabehöhe nicht angegeben sind oder 0, stimmen die Ausgabebreite und -höhe mit der endgültigen Bildbreite und -höhe überein. Wenn die Ausgabebreite angegeben wird, ist die Ausgabehöhe proportional zur Ausgabebreite
  • 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
  • Standard: Seitengröße Höhe
  • Minimum: 15
• 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:
    • Print
    • 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
    • Rechtliches
    • 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
  • Schleife nie: -1
• 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 des einzigen HTML-Elements auf der Zielwebseite, das 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: Wenn sowohl die Ausgabebreite als auch die Ausgabehöhe nicht angegeben sind oder 0, stimmen die Ausgabebreite und -höhe mit der endgültigen Bildbreite und -höhe überein. Wenn die Ausgabehöhe angegeben wird, ist die Ausgabebreite proportional zur Ausgabehöhe
  • 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
  • Standard: Seitengröße Breite
  • Minimum: 15
• 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.