Tools om het web vast te leggen en te converteren

Take Website Screenshots with our RESTful Screenshot APIREST API

Met de REST API van GrabzIt kunt u URL's of HTML volledig vastleggen met RESTful-technieken. Lees, voordat u begint, de volgende voorbehouden zorgvuldig door, afhankelijk van uw gebruiksscenario, een van onze andere API-oplossingen is wellicht geschikter.

  • - Some features such as merging and encrypting captures are not available through this REST API. To use these features you will need to use another API-bibliotheek
  • - Gebruik deze API niet aan de kant van de klant, het zal uw toepassingssleutel onthullen! Gebruik in plaats daarvan de JavaScript API

Om te beginnen, selecteert u gewoon wat u wilt doen in het onderstaande filter en de beschikbare parameters worden samen met een eenvoudig voorbeeld weergegeven.

Zorg ervoor bij het maken van verzoeken alle parameterwaarden zijn URL-gecodeerd.

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

Bij het converteren van HTML moeten alle parameters zijn geplaatst in de aanvraagtekst als sleutel / waarde-paren. Zorg ervoor dat alle parameterwaarden URL-gecodeerd zijn.

    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    

The following additional options are available with this type of capture, all of which are optional except for those marked as required. When testing the API functionality we recommend using Postbode om het proces te vereenvoudigen.

  • url - the URL to the capture.
    • Nodig
  • html - the HTML to the convert.
    • Nodig
    • When converting HTML you must use a HTTP POST.
  • sleutel - your Applicatiesleutel.
    • Nodig
  • Bel terug - the URL of the handler GrabzIt should call after it has completed its work.
  • customid - the custom identifier that you can associate with the capture.
    • This will be returned with any callback URL you have specified.
  • formaat - the format the capture should be in.
    • Standaard: jpg
    • Opties:
      • bmp8
      • bmp16
      • bmp24
      • bmp
      • csv
        • CSV-bestanden worden automatisch gedownload.
      • gif
      • html
        • HTML-bestanden worden automatisch gedownload.
      • jpg
      • json
        • JSON-bestanden worden automatisch gedownload.
      • pdf
        • PDF-bestanden worden automatisch gedownload.
      • docx
        • DOCX-bestanden worden automatisch gedownload.
      • png
      • tiff
      • webp
      • xlsx
        • XLSX-bestanden worden automatisch gedownload.
  • address - de URL om de HTML-code in uit te voeren. Kan handig zijn als de HTML die wordt geconverteerd relatieve URL's gebruikt naar bronnen zoals CSS en afbeeldingen.
    • Standaard: leeg
  • background - indien waar, moet de achtergrond van de webpagina in de PDF worden opgenomen
    • Standaard: 1
    • Opties:
      • 0 = geeft aan dat het PDF-document de webpagina-achtergrond niet mag bevatten
      • 1 = geeft aan dat het PDF-document de webpagina-achtergrond moet bevatten
  • background - indien waar, moeten de achtergrondafbeeldingen van de webpagina worden opgenomen in de DOCX
    • Standaard: 1
    • Opties:
      • 0 = geeft aan dat het DOCX-document geen achtergrondafbeeldingen van de webpagina mag bevatten
      • 1 = geeft aan dat het DOCX-document de achtergrondafbeeldingen van de webpagina moet bevatten
  • bwidth - de breedte van de browser in pixels
    • Waarschuwing deze functie is momenteel in bèta en biedt mogelijk geen consistente resultaten.
    • Standaard: 1024
    • Maximaal: 10000
    • Automatische breedte: -1 (doorgeven van -1 betekent dat de breedte van de browser komt overeen met de breedte van het document)
  • bheight - de hoogte van de browser in pixels.
    • Standaard: 768
    • Maximaal: 10000
    • Volledige lengte: -1 (doorgeven van -1 betekent dat een sceenshot van de hele webpagina wordt gemaakt)
  • country - het land de screenshot / opname moet worden genomen.
    • Waarschuwing deze functie is momenteel in bèta en biedt mogelijk geen consistente resultaten.
    • Standaard: de huidige snelste locatie
    • Opties: "SG", "UK", "US"
  • coverurl - de URL van een webpagina die als voorblad voor de PDF moet worden gebruikt
    • Standaard: leeg
  • customwatermarkid - Voeg een ... toe aangepast watermerk naar het bestand
    • Standaard: leeg
  • delay - het aantal milliseconden tot wacht voordat je de screenshot maakt
    • Standaard: 0
    • Maximaal: 30000
  • duur - de lengte in seconden van de video die moet worden geconverteerd intoa geanimeerde GIF.
    • Standaard: maximale lengte voor pakket
  • export - de export URL die aangeeft waar de opname ook moet worden geëxporteerd.
  • filename - overschrijf de bestandsnaam van het gedownloade bestand
    • Alleen geldig wanneer de screenshot / opname wordt gedownload
    • Standaard: leeg
  • fps - het aantal frames per seconde dat moet worden vastgelegd van de video.
    • Standaard: 10
    • Minimum: 0.2
    • Maximaal: 60
  • hd - indien waar de afbeelding vastleggen zal in hoge definitie zijn dit verdubbelt de grootte van de afbeeldingsafmetingen.
    • Standaard: 0
    • Opties:
      • 0 = maak een high-definition afbeelding
      • 1 = maak een high-definition afbeelding
  • height - de hoogte van de resulterende miniatuur in pixels
    • Standaard: de hoogst mogelijke browserhoogte die binnen de maximale hoogte voor het gebruikerspakket past
    • Maximum: maximale hoogte voor pakket
    • Volledige hoogte: -1 (doorgeven van -1 betekent dat de hoogte van de miniatuur niet wordt verkleind)
  • height - de aangepaste hoogte van het resulterende document in mm
  • hoogte - de hoogte van de resulterende geanimeerde GIF in pixels.
    • Standaard: 120px
    • Maximum: maximale hoogte voor pakket
    • Auto-formaat: -1 (passeren van -1 betekent dat de hoogte van de geanimeerde GIF is geschaald in verhouding tot de breedte, als de hoogte automatisch wordt aangepast, kan de breedte niet)
  • hide - de id of klasse CSS-selectors van de een of meer HTML-elementen op de webpagina die u wilt verbergen, om meerdere HTML-elementen op te geven om elke selector met een komma te verbergen.
    • Standaard: leeg
  • includealltables - indien waar, worden alle tabellen op de webpagina geëxtraheerd en wordt elke tabel in een afzonderlijk werkblad weergegeven.
    • Alleen beschikbaar met het XLSX-formaat
    • Standaard: 0
    • Opties:
      • 0 = geeft aan dat alle tabellen niet worden geëxtraheerd
      • 1 = geeft aan dat alle tabellen worden geëxtraheerd
  • includeheadernames - of echte kopnamen in de tabel worden opgenomen
    • Standaard: 1
    • Opties:
      • 0 = geeft aan dat de kopnamen niet in de tabel worden opgenomen
      • 1 = geeft aan dat de kopnamen in de tabel worden opgenomen
  • includeimages - indien waar, moeten de afbeeldingen van de webpagina worden opgenomen in de DOCX
    • Standaard: 1
    • Opties:
      • 0 = geeft aan dat het DOCX-document geen afbeeldingen van webpagina's zal bevatten
      • 1 = geeft aan dat het DOCX-document afbeeldingen van webpagina's zal bevatten
  • includelinks - waar als links in het document moeten worden opgenomen
    • Standaard: 1
    • Opties:
      • 0 = geeft aan dat het document geen links mag bevatten
      • 1 = geeft aan dat het document links moet bevatten
  • includeoutline - waar als PDF-bladwijzers moet worden opgenomen
    • Standaard: 0
    • Opties:
      • 0 = geeft aan dat het PDF-document geen overzicht bevat
      • 1 = geeft aan dat het PDF-document een overzicht zal bevatten
  • mergeid - voeg de ID toe van een opname die zou moeten zijn samengevoegd aan het begin van het nieuwe document
    • Standaard: leeg
  • mtop - de marge in millimeter die bovenaan de documentpagina moet verschijnen
    • Standaard: 10
  • mleft - de marge in millimeters die links van de documentpagina moet verschijnen
    • Standaard: 10
  • mbottom - de marge in millimeter die onderaan de documentpagina moet verschijnen
    • Standaard: 10
  • mright - de marge in millimeters die rechts van het PDF-document moet verschijnen
    • Standaard: 10
  • media - de CSS-mediatype van het PDF-document
    • Standaard: Print
    • Opties:
      • Print
      • scherm
  • noads - als het waar is advertenties moeten automatisch worden verborgen.
    • Standaard: 0
    • Opties:
      • 0 = advertenties weergeven
      • 1 = advertenties verbergen
  • nonotify - indien waar allemaal algemeen gevonden cookiemeldingen moeten automatisch worden verborgen.
    • Standaard: 0
    • Opties:
      • 0 = cookiemeldingen weergeven
      • 1 = cookiemeldingen verbergen
  • orientation - de richting van het document
    • Standaard: portret
    • Opties:
      • Portret
      • Landschap
  • pagesize - het paginaformaat van het document
    • Standaard: A4
    • Opties:
      • A3
      • A4
      • A5
      • A6
      • B3
      • B4
      • B5
      • B6
      • JURIDISCH
      • Letter
  • password - de wachtwoord om het document te beschermen met in de titel
    • Standaard: leeg
  • proxy - de HTTP-proxygegevens de browsersoftware moet gebruiken om deze opname te maken
  • post - alle postparameters die u wilt verzenden.
  • quality - de kwaliteit van de opname, JPG en GIF hebben een standaardcompressie van 85% en WEBP 80%. Deze parameter heeft geen effect op BMP-, PNG- of TIFF-afbeeldingen.
    • Het verminderen van de kwaliteit zal de bestandsgrootte verminderen en downloadtijden verkorten.
    • Standaard: -1
    • Minimum: -1
    • Maximaal: 100
  • herhaling - aantal keren dat de geanimeerde GIF in een lus moet worden geplaatst.
    • Standaard: 0
    • Lus continu: 0
  • omkeren - indien waar, worden de frames van de geanimeerde GIF omgekeerd
    • Standaard: 0
    • Opties:
      • 0 = geeft aan dat de animatie niet zal worden teruggezet
      • 1 = geeft aan dat de animatie wordt omgekeerd
  • requestas - het type user-agent dat u wilt gebruiken
    • Standaard: 0
    • Opties:
      • 0 = geeft aan dat de standaardversie van de website moet worden geretourneerd
      • 1 = geeft de mobiele versie van een website moet worden geretourneerd
      • 2 = geeft aan dat de zoekmachineweergave van een website moet worden geretourneerd
      • 3 = geeft aan dat de terugvalversie van een website moet worden geretourneerd met een user-agent van een standaardbrowser
  • snelheid - de snelheid van de geanimeerde GIF.
    • Standaard: 1
    • Minimum: 0.2
    • Maximaal: 10
  • begin - de startpositie van de video die moet worden geconverteerd intoa geanimeerde GIF.
    • Standaard: 0 seconden
  • tabletoinclude - de index van de te converteren tabel, waarbij alle tabellen op een webpagina van boven naar beneden zijn geordend
    • Standaard: 1
  • target - deze parameter geeft de id of klasse aan CSS-selector van het enige HTML-element op de doelwebpagina dat moet worden omgedraaid intoa document, worden alle andere delen van de webpagina genegeerd. Als er meerdere overeenkomende HTML-elementen zijn, wordt de eerste gekozen.
    • Standaard: leeg
  • target - deze parameter specificeert de id of klasse CSS-selector van het enige HTML-element op de doelpagina die moet worden omgedraaid intoa afbeelding, worden alle andere delen van de webpagina genegeerd. Als er meerdere overeenkomende HTML-elementen zijn, wordt de eerste gekozen.
    • Standaard: leeg
  • target - de id van het enige HTML-element op de webpagina dat moet worden gebruikt om tabellen uit te halen
    • Standaard: leeg
  • transparent - indien waar beeldopname moet transparant zijn. Dit is alleen compatibel met png- en tiff-afbeeldingen.
    • Standaard: 0
    • Opties:
      • 0 = maak een niet-transparante afbeelding
      • 1 = maak een transparante afbeelding
  • templateid - Voeg een ... toe sjabloon ID die de kop- en voettekst van het document aangeeft
    • Standaard: leeg
  • title - geef een titel op voor het PDF-document
    • Standaard: leeg
  • waitfor - dit specificeert de id of klasse van een HTML-element, met behulp van een CSS-selector. Zodra het element is zichtbaar wordt de opname uitgevoerd. Als er meerdere overeenkomende HTML-elementen zijn, wordt de eerste gekozen. Wanneer deze parameter wordt gebruikt, wacht deze maximaal 25 seconden voordat de opname wordt uitgevoerd.
  • width - de breedte van de resulterende miniatuur in pixels
    • Standaard: de hoogst mogelijke browserbreedte die binnen de maximale breedte voor het gebruikerspakket past
    • Maximum: maximale breedte voor pakket
    • Volledige breedte: -1 (passeren van -1 betekent dat de breedte van de miniatuur niet wordt verkleind)
  • width - de aangepaste breedte van het resulterende document in mm
  • breedte - de breedte van de resulterende geanimeerde GIF in pixels.
    • Standaard: 180px
    • Maximum: maximale breedte voor pakket
    • Auto-formaat: -1 (passerend -1 betekent dat de breedte van de geanimeerde GIF is geschaald in verhouding tot de hoogte, als de breedte automatisch wordt aangepast, kan de hoogte niet)