Tools om het web vast te leggen en te converteren

Maak website-screenshots met onze 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.

  • - Sommige functies, zoals het samenvoegen en versleutelen van vastleggingen, zijn niet beschikbaar via deze REST API. Om deze functies te gebruiken, moet u een andere gebruiken 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    

De volgende aanvullende opties zijn beschikbaar bij dit type vastlegging, die allemaal optioneel zijn, behalve degene die zijn gemarkeerd als vereist. Bij het testen van de API-functionaliteit raden we aan om te gebruiken Postbode om het proces te vereenvoudigen.

  • url - de URL naar de opname.
    • Nodig
  • html - de HTML naar de conversie.
    • Nodig
    • Bij het converteren van HTML moet je een HTTP POST gebruiken.
  • sleutel - uw Applicatiesleutel.
    • Nodig
  • Bel terug - de URL van de handler GrabzIt moet aanroepen nadat deze zijn werk heeft voltooid.
  • customid - de aangepaste ID die u aan de opname kunt koppelen.
    • Dit wordt geretourneerd met elke callback-URL die u hebt opgegeven.
  • formaat - het formaat waarin de opname moet zijn.
    • 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 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 and WEBP have a default compression of 90% and GIF 85%. This parameter has no effect on BMP, PNG or TIFF images.
    • 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
  • 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 specificeert de 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 CSS-selector van de 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 het 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)