RESTful Ekran Görüntüsü API'mız ile Web Sitesi Ekran Görüntüleri Alın

GrabzIt'ın REST API'sı, URL'leri veya HTML'yi tamamen RESTful tekniklerini kullanarak yakalamanıza olanak tanır. Başlamadan önce, lütfen kullanım durumunuza bağlı olarak aşağıdaki uyarıları dikkatlice okuyun, diğer API çözümlerimizden biri daha uygun olabilir.

- Yakalama ve şifreleme gibi bazı özellikler bu REST API'sinde kullanılamaz. Bu özellikleri kullanmak için başka bir özellik kullanmanız gerekir. API Kütüphanesi
- Bu API'yi istemci tarafında kullanmayın, Uygulama Anahtarınızı gösterecektir! Bunun yerine JavaScript API'sı

Başlamak için aşağıdaki filtreden ne yapmak istediğinizi seçmeniz yeterlidir, mevcut parametreler temel bir örnekle birlikte görüntülenir.

Ne yapmak istiyorsun?

İstekte bulunurken lütfen herşey parametre değerleri URL kodludur.

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

HTML dönüştürülürken tüm parametreler istek gövdesinde yayınlandı anahtar/değer çiftleri olarak. Tüm parametre değerlerinin URL kodlu olduğundan ve içerik türünün application / x-www-form-urlencoded.

    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

Yakalama daha sonra HTTP yanıtında döndürülür. Bu tür yakalamada aşağıdaki ek seçenekler de mevcuttur ve gerekli olarak işaretlenenler dışında tümü isteğe bağlıdır. API işlevselliğini test ederken kullanmanızı öneririz Postacı süreci basitleştirmek için.

url - ele geçirmenin URL'si.
- gereklidir
html - dönüştürülecek HTML.
- gereklidir
- HTML'yi dönüştürürken bir HTTP POST kullanmanız gerekir.
anahtar - sizin Uygulama anahtarı.
- gereklidir
geri aramak - GrabzIt işleyicisinin URL'si, işini tamamladıktan sonra aramalıdır.
- Her dilin belgelerini izleyerek nasıl işleyici oluşturacağınızı öğrenin ASP.NET, Java, node.js, Perl, PHP, Python ve Yakut.
özel kimlik - yakalamayla ilişkilendirebileceğiniz özel tanımlayıcı.
- Bu, belirttiğiniz herhangi bir geri arama URL'siyle döndürülür.
biçim - yakalamanın olması gereken biçim.
- Varsayılan: jpg
- Seçenekler:
  - bmp8
  - bmp16
  - bmp24
  - bmp
  - csv
  - gif
  - html
  - jpg
  - json
  - pdf
  - docx
  - png
  - SEO
  - kızma
  - webp
  - xlsx
address - HTML kodunu çalıştırmak için kullanılacak URL. Dönüştürülen HTML, CSS ve görüntüler gibi kaynaklara göreli URL'ler kullanıyorsa yararlı olabilir.
- Varsayılan: boş
background - doğruysa, web sayfasının arka planı PDF’ye dahil edilmelidir
- Varsayılan: 1
- Seçenekler:
  - 0 = PDF belgesinin web sayfası arka planını içermemesi gerektiğini belirtir
  - 1 = PDF belgesinin web sayfası arka planını içermesi gerektiğini belirtir
background - doğruysa, web sayfasının arka plan görüntüleri DOCX’e dahil edilmelidir
- Varsayılan: 1
- Seçenekler:
  - 0 = DOCX belgesinin web sayfası arka plan resimlerini içermemesi gerektiğini belirtir
  - 1 = DOCX belgesinin web sayfası arka plan resimlerini içermesi gerektiğini belirtir
bwidth - tarayıcının piksel cinsinden genişliği
- Bu özelliğin uyarısı şu anda beta aşamasındadır ve tutarlı sonuçlar vermeyebilir.
- Varsayılan: 1366
- Maksimum: 10000
- Otomatik Genişlik: -1 (-1'i geçmek, tarayıcının genişliği belgenin genişliğine uyuyor)
bheight - tarayıcının piksel cinsinden yüksekliği.
- Varsayılan: 1170
- Maksimum: 10000
- Tam Boy: -1 (-1'i geçmek, tüm web sayfasının bir kısmının alındığı anlamına gelir)
click - bu, bir kullanarak HTML öğesini belirtir CSS seçici tıklamak. Tıklamanın etkilerini görmek için de bir gecikme gerekebileceğini unutmayın.
- Bu özelliğin uyarısı şu anda beta aşamasındadır ve tutarlı sonuçlar vermeyebilir.
country - ülke Ekran görüntüsü / yakalama alınmalıdır.
- Varsayılan: Geçerli en hızlı konum
- Seçenekler: "SG", "İngiltere", "ABD"
coverurl - PDF için kapak sayfası olarak kullanılması gereken bir web sayfasının URL'si
- Varsayılan: boş
customwatermarkid - ekle görenek watermark dosyaya
- Varsayılan: boş
delay - milisaniye ekran görüntüsünü almadan önce bekleyin
- Varsayılan: 0
- Maksimum: 30000
süre - dönüştürülmesi gereken videonun saniye cinsinden uzunluğu into bir animasyonlu GIF.
- Varsayılan: paket için maksimum uzunluk
export - URL’yi dışa aktar Bu, yakalamanın nerede dışa aktarılacağını da belirtir.
fps - Videodan yakalanması gereken saniye başına kare sayısı.
- Varsayılan: 10
- Minimum: 0.2
- Maksimum: 60
hd - eğer görüntü doğruysa yakalama yüksek çözünürlükte olacak bu, görüntü boyutlarının boyutunu ikiye katlar.
- Varsayılan: 0
- Seçenekler:
  - 0 = yüksek çözünürlüklü bir görüntü oluştur
  - 1 = yüksek çözünürlüklü bir görüntü oluştur
height - sonuçtaki küçük resmin piksel cinsinden yüksekliği
- Varsayılan: hem çıktı genişliği hem de çıktı yüksekliği belirtilmezse veya 0 ise, çıktı genişliği ve yüksekliği son görüntü genişliği ve yüksekliğiyle eşleşir, çıktı genişliği belirtilirse çıktı yüksekliği çıktı genişliğiyle orantılı olur
- Maksimum: Paket için maksimum yükseklik
- Tam Boy: -1 (-1'ten geçmek, küçük resmin yüksekliğinin azaltılmadığı anlamına gelir)
height - elde edilen belgenin özel yüksekliği mm olarak
- Varsayılan: sayfa boyutu yükseklik
- Minimum: 15
yükseklik - sonuçtaki animasyonlu GIF'in piksel cinsinden yüksekliği.
- Varsayılan: 120px
- Maksimum: Paket için maksimum yükseklik
- Otomatik boyut: -1 (-1’in geçilmesi, animasyonlu GIF ölçeklendirilir genişliğine göre, yükseklik otomatik olarak boyutlandırılıyorsa genişlik
hide - CSS seçicileri Web sayfasındaki bir veya daha fazla HTML öğesinin gizlenmesini, gizlenecek birden çok HTML öğesinin belirtilmesini sağlamak için her seçiciyi virgülle ayırın.
- Varsayılan: boş
includealltables - doğruysa, web sayfasındaki tüm tabloların her biri ayrı bir e-tablo sayfasında görünecek şekilde çıkartılacaktır.
- Yalnızca XLSX formatıyla kullanılabilir
- Varsayılan: 0
- Seçenekler:
  - 0 = tüm tabloların çıkarılmayacağını belirtir
  - 1 = tüm tabloların çıkarılacağını belirtir
includeheadernames - eğer gerçek başlık isimleri tabloya dahil edilecekse
- Varsayılan: 1
- Seçenekler:
  - 0 = başlık adlarının tabloya dahil edilmeyeceğini belirtir
  - 1 = başlık isimlerinin tabloya dahil edileceğini gösterir
includeimages - doğruysa, web sayfasının görüntüleri DOCX’e dahil edilmelidir
- Varsayılan: 1
- Seçenekler:
  - 0 = DOCX belgesinin web sayfası görüntüleri içermeyeceğini belirtir
  - 1 = DOCX belgesinin web sayfası resimlerini içereceğini gösterir
includelinks - Bağlantılar belgeye dahil edildiyse geçerlidir
- Varsayılan: 1
- Seçenekler:
  - 0 = belgenin bağlantılar içermemesi gerektiğini belirtir
  - 1 = belgenin bağlantılar içermesi gerektiğini gösterir
includeoutline - eğer doğru PDF yer imleri yer verilmeli
- Varsayılan: 0
- Seçenekler:
  - 0 = PDF belgesinin anahat içermeyeceğini belirtir
  - 1 = PDF belgesinin anahat içereceğini gösterir
mergeid - olması gereken bir yakalamanın kimliğini ekleyin yeni belgenin başında birleştirildi
- Varsayılan: boş
mtop - Belge sayfasının üstünde görünmesi gereken milimetre cinsinden kenar boşluğu
- Varsayılan: 10
mleft - Belge sayfasının solunda görünmesi gereken milimetre cinsinden kenar boşluğu
- Varsayılan: 10
mbottom - Belge sayfasının altında görünmesi gereken milimetre cinsinden kenar boşluğu
- Varsayılan: 10
mright - PDF belgesinin sağında görünmesi gereken milimetre cinsinden kenar boşluğu
- Varsayılan: 10
media - PDF belgesinin CSS Medya Türü
- Varsayılan: Print
- Seçenekler:
  - Print
  - Ekran
noads - Eğer doğruysa reklamlar otomatik olarak gizlenmeli.
- Varsayılan: 0
- Seçenekler:
  - 0 = görüntülü reklamlar
  - 1 = reklamları gizle
nonotify - doğruysa, yaygın olarak bulunanlar: çerez bildirimleri otomatik olarak gizlenmelidir.
- Varsayılan: 0
- Seçenekler:
  - 0 = çerez bildirimlerini görüntüle
  - 1 = çerez bildirimlerini gizle
orientation - belgenin yönlendirilmesi
- Varsayılan: Portre
- Seçenekler:
  - Portre
  - peyzaj
pagesize - belgenin sayfa boyutu
- Varsayılan: A4
- Seçenekler:
  - A3
  - A4
  - A5
  - A6
  - B3
  - B4
  - B5
  - B6
  - Yasal
  - mektup
password - belgeyi korumak için parola ile
- Varsayılan: boş
proxy - HTTP vekil detayları tarayıcı yazılımı bu yakalamayı oluşturmak için kullanmak için kullanmalıdır
post - göndermek istediğiniz gönderi parametreleri.
quality - yakalamanın kalitesiJPG ve WEBP'nin varsayılan sıkıştırması% 90 ve GIF% 85'tir. Bu parametrenin BMP, PNG veya TIFF görüntüleri üzerinde etkisi yoktur.
- Kaliteyi düşürmek dosya boyutunu azaltır ve indirme sürelerini azaltır.
- Varsayılan: -1
- Minimum: -1
- Maksimum: 100
tekrar et - animasyonlu GIF'i döngülemek için kaç kez?
- Varsayılan: 0
- Sürekli Döngü: 0
- Asla Döngü: -1
ters - true ise, animasyonlu GIF’in kareleri ters çevrilir
- Varsayılan: 0
- Seçenekler:
  - 0 = animasyonun geri döndürülmeyeceğini belirtir
  - 1 = animasyonun ters çevrileceğini gösterir
requestas - kullanmak istediğiniz kullanıcı aracısının türü
- Varsayılan: 0
- Seçenekler:
  - 0 = web sitesinin standart versiyonunun iade edilmesi gerektiğini belirtir
  - 1 = mobil versiyonu bir web sitesinin döndürülmesi gerekir
  - 2 = bir web sitesinin arama motoru görünümünün döndürülmesi gerektiğini belirtir
hız - animasyonlu GIF'in hızı.
- Varsayılan: 1
- Minimum: 0.2
- Maksimum: 10
başlama - dönüştürülmesi gereken videonun başlangıç konumu into bir animasyonlu GIF.
- Varsayılan: 0 saniye
tabletoinclude - dönüştürülecek tablonun dizini, bir web sayfasındaki tüm tablolar web sayfasının başından sonuna doğru sipariş edildi.
- Varsayılan: 1
target - bu parametre CSS seçici döndürülecek hedef web sayfasındaki tek HTML öğesinin açıklaması intBir belgede, web sayfasının diğer tüm bölümleri göz ardı edilir. Birden fazla eşleşen HTML öğesi varsa, ilki seçilir.
- Varsayılan: boş
target - bu parametre CSS seçici döndürülecek hedef web sayfasındaki tek HTML öğesinin açıklaması intBir görüntüde, web sayfasının diğer tüm bölümleri göz ardı edilir. Birden fazla eşleşen HTML öğesi varsa, ilki seçilir.
- Varsayılan: boş
target - web sayfasındaki tabloları çıkarmak için kullanılması gereken tek HTML öğesinin kimliği
- Varsayılan: boş
transparent - eğer doğruysa görüntü yakalama şeffaf olmalıdır. Bu sadece png ve tiff görüntüleriyle uyumludur.
- Varsayılan: 0
- Seçenekler:
  - 0 = saydam olmayan bir görüntü oluştur
  - 1 = şeffaf bir görüntü oluştur
templateid - ekle şablon Belgenin üstbilgisini ve altbilgisini belirten kimlik
- Varsayılan: boş
title - PDF belgesine bir başlık girin
- Varsayılan: boş
waitfor - bu, bir kullanarak HTML öğesini belirtir CSS seçici. Öğe bir kere görünür yakalama yürütülür. Birden fazla eşleşen HTML öğesi varsa, ilki seçilir. Bu parametre kullanıldığında, çekim yapılmadan önce maksimum 25 saniye bekleyecektir.
width - sonuçtaki küçük resmin piksel cinsinden genişliği
- Varsayılan: hem çıktı genişliği hem de çıktı yüksekliği belirtilmezse veya 0 ise çıktı genişliği ve yüksekliği son görüntü genişliği ve yüksekliğiyle eşleşir, çıktı yüksekliği belirtilirse çıktı genişliği çıktı yüksekliğiyle orantılı olur
- Maksimum: Paket için maksimum genişlik
- Tam Genişlik: -1 (-1'ten geçmek, küçük resmin genişliğinin azaltılmadığı anlamına gelir)
width - elde edilen belgenin özel genişliği mm olarak
- Varsayılan: sayfa boyutu genişlik
- Minimum: 15
genişlik - sonuçtaki animasyonlu GIF'in piksel cinsinden genişliği.
- Varsayılan: 180px
- Maksimum: Paket için maksimum genişlik
- Otomatik boyut: -1 (-1’in geçilmesi, animasyonlu GIF ölçeklendirilir yüksekliği ile ilgili olarak, genişlik otomatik olarak boyutlandırılıyorsa, yükseklik

Hata işleme

API'ye yaptığınız istekle ilgili bir sorun varsa, hatayı açıklayan bir JSON nesnesi döndürülür. Bunu belirlemenin en iyi yolu, işlemeden önce yanıtın içerik türünü kontrol etmektir. application/json bir hata oluştu. JSON'da bulunan hata kodu şu şekildedir: standart kod listesi.

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