RESTful Screenshot API로 웹 사이트 스크린 샷 찍기

GrabzIt의 REST API를 사용하면 RESTful 기술을 사용하여 URL 또는 HTML을 완전히 캡처 할 수 있습니다. 시작하기 전에 사용 사례에 따라 다음 API를주의 깊게 읽어보십시오. 다른 API 솔루션 중 하나가 더 적합 할 수 있습니다.

-캡처 병합 및 암호화와 같은 일부 기능은이 REST API를 통해 사용할 수 없습니다. 이 기능을 사용하려면 다른 기능을 사용해야합니다 API 라이브러리
-클라이언트 측에서이 API를 사용하지 마십시오. 응용 프로그램 키가 노출됩니다! 대신에 자바 스크립트 API

시작하려면 아래 필터에서 원하는 것을 선택하면 사용 가능한 매개 변수가 기본 예제와 함께 표시됩니다.

뭐하고 싶어?

요청시 반드시 확인하십시오 모든 매개 변수 값은 URL로 인코딩됩니다.

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

HTML을 변환 할 때 모든 매개 변수는 요청 본문에 게시 키-값 쌍으로. 모든 매개변수 값이 URL로 인코딩되고 콘텐츠 유형이 응용 프로그램 / 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

그러면 캡처가 HTTP 응답에 반환됩니다. 이 유형의 캡처에서는 다음 추가 옵션도 사용할 수 있으며 필수로 표시된 옵션을 제외하고 모두 선택 사항입니다. API 기능을 테스트 할 때 다음을 사용하는 것이 좋습니다. 우편 집배원 프로세스를 단순화합니다.

URL -캡처 할 URL입니다.
- 필수
HTML -HTML을 변환합니다.
- 필수
- HTML을 변환 할 때는 HTTP POST를 사용해야합니다.
키 -너의 응용 프로그램 키.
- 필수
콜백 -처리기의 URL GrabzIt은 작업이 완료된 후 호출해야합니다.
- 각 언어의 문서를 따라 핸들러를 작성하는 방법을 찾으십시오. ASP.NET, 자바, Node.js를, 펄, PHP, Python 및 루비.
사용자 정의 -캡처와 연관시킬 수있는 사용자 정의 식별자.
- 지정한 모든 콜백 URL과 함께 반환됩니다.
체재 -캡처 형식이어야합니다.
- 기본 : jpg
- 옵션 :
  - bmp8
  - bmp16
  - bmp24
  - BMP
  - csv 파일
  - 지프
  - HTML
  - JPG
  - JSON
  - PDF
  - DOCX
  - PNG
  - 검색 엔진 최적화
  - 사소한 말다툼
  - mp4
  - 웹
  - XLSX
address -HTML 코드를 실행할 URL입니다. 변환되는 HTML이 상대 URL을 사용하여 CSS 및 이미지와 같은 리소스에 사용하는 경우 유용 할 수 있습니다.
- 기본값 : 비어 있음
background -참이면 웹 페이지의 배경이 PDF에 포함되어야합니다
- 기본값 : 1
- 옵션 :
  - 0 =는 PDF 문서가 웹 페이지 배경을 포함하지 않아야 함을 나타냅니다.
  - 1 = PDF 문서에 웹 페이지 배경이 포함되어야 함을 나타냅니다.
background -참이면 웹 페이지의 배경 이미지가 DOCX에 포함되어야합니다.
- 기본값 : 1
- 옵션 :
  - 0 = DOCX 문서에 웹 페이지 배경 이미지가 포함되지 않아야 함을 나타냅니다.
  - 1 = DOCX 문서에 웹 페이지 배경 이미지가 포함되어야 함을 나타냅니다.
bwidth -픽셀 단위의 브라우저 너비
- 경고이 기능은 현재 베타 버전이며 일관된 결과를 제공하지 않을 수 있습니다.
- 기본값 : 1366
- 최대 : 10000
- 자동 폭 : -1 (-1를 전달하면 브라우저 너비 문서의 너비와 일치)
bheight -브라우저의 높이 (픽셀)입니다.
- 기본값 : 1170
- 최대 : 10000
- 전체 길이 : -1 (-1를 통과하면 전체 웹 페이지의 sceenshot이 생성됨을 의미 함)
click -이것은 HTML 요소를 지정합니다. CSS 선택기 클릭하다. 클릭의 효과를 보려면 지연이 필요할 수도 있습니다.
- 경고이 기능은 현재 베타 버전이며 일관된 결과를 제공하지 않을 수 있습니다.
country - 이 나라 스크린 샷 / 캡처를 가져와야합니다.
- 기본값 : 현재 가장 빠른 위치
- 옵션 : "SG", "UK", "US"
coverurl -PDF 표지로 사용해야하는 웹 페이지의 URL
- 기본값 : 비어 있음
customwatermarkid - 추가하다 관습 watermark 파일로
- 기본값 : 비어 있음
delay -밀리 초 수 스크린 샷을 찍기 전에 기다리십시오
- 기본값 : 0
- 최대 : 30000
지속 -변환해야하는 비디오 길이 (초) intoa 애니메이션 GIF.
- 기본값 : 패키지의 최대 길이
지속 - the length in seconds of the web page should be recorded for.
- 기본값 : 패키지의 최대 길이
export - 내보내기 URL 캡처를 내보낼 위치를 지정합니다.
FPS - the number of frames per second that should be captured.
- 기본값 : 10
- 최소 : 0.2
- 최대 : 60
hd -참이면 이미지 캡처는 고화질입니다 이미지 크기의 두 배가됩니다.
- 기본값 : 0
- 옵션 :
  - 0 = 고화질 이미지 생성
  - 1 = 고화질 이미지 생성
height -결과 썸네일의 높이 (픽셀 단위)
- 기본값 : 출력 너비와 출력 높이가 모두 지정되지 않았거나 0이면 출력 너비와 높이가 최종 이미지 너비와 높이와 일치하고, 출력 너비가 지정되면 출력 높이가 출력 너비에 비례합니다.
- 최대 : 패키지의 최대 높이
- 전체 높이 : -1 (-1를 전달하면 축소판의 높이가 줄어들지 않음을 의미)
height - 결과 문서의 사용자 정의 높이 단위 : mm
- 태만: 페이지 크기 신장
- 최소 : 15
신장 -결과 애니메이션 GIF의 높이 (픽셀 단위).
- 기본값 : 120px
- 최대 : 패키지의 최대 높이
- 자동 크기 : -1 (-1를 전달하면 애니메이션 GIF 크기 조정 너비와 관련하여 높이가 자동 크기 인 경우 너비를 사용할 수 없습니다)
hide - CSS 선택기 웹 페이지에서 하나 이상의 HTML 요소를 숨겨서 숨기려면 여러 HTML 요소를 지정하여 각 선택기를 쉼표로 구분하십시오.
- 기본값 : 비어 있음
includealltables -true 인 경우 웹 페이지의 모든 표가 추출되어 각 표가 별도의 스프레드 시트 시트에 나타납니다.
- XLSX 형식에서만 사용 가능
- 기본값 : 0
- 옵션 :
  - 0 = 모든 테이블이 추출되지 않음을 나타냅니다.
  - 1 = 모든 테이블이 추출됨을 나타냅니다.
includeheadernames -실제 헤더 이름이 테이블에 포함되는 경우
- 기본값 : 1
- 옵션 :
  - 0 =는 헤더 이름이 테이블에 포함되지 않음을 나타냅니다
  - 1 =는 헤더 이름이 테이블에 포함될 것임을 나타냅니다.
includeimages -참이면 웹 페이지의 이미지가 DOCX에 포함되어야합니다
- 기본값 : 1
- 옵션 :
  - 0 = DOCX 문서에 웹 페이지 이미지가 포함되지 않음을 나타냅니다
  - 1 = DOCX 문서에 웹 페이지 이미지가 포함됨을 나타냅니다.
includelinks -문서에 링크를 포함해야하는 경우 true
- 기본값 : 1
- 옵션 :
  - 0 = 문서에 링크가 포함되지 않아야 함을 나타냅니다.
  - 1 = 문서가 링크를 포함해야 함을 나타냅니다.
includeoutline -그렇다면 PDF 북마크 포함되어야한다
- 기본값 : 0
- 옵션 :
  - 0 = PDF 문서에 윤곽선이 포함되지 않음을 나타냅니다
  - 1 = PDF 문서에 윤곽선이 포함됨을 나타냅니다.
mergeid -캡처의 ID를 추가해야합니다. 새 문서의 시작 부분에 병합
- 기본값 : 비어 있음
mtop -문서 페이지 상단에 표시되어야하는 밀리미터 단위의 여백
- 기본값 : 10
mleft -문서 페이지 왼쪽에 표시되어야하는 밀리미터 단위의 여백
- 기본값 : 10
mbottom -문서 페이지 하단에 표시되어야하는 밀리미터 단위의 여백
- 기본값 : 10
mright -PDF 문서의 오른쪽에 나타나는 밀리미터 단위의 여백
- 기본값 : 10
media - PDF 문서의 CSS 미디어 유형
- 기본 : Print
- 옵션 :
  - Print
  - 화면
noads - 사실이면 광고는 자동으로 숨겨져 야합니다.
- 기본값 : 0
- 옵션 :
  - 0 = 디스플레이 광고
  - 1 = 광고 숨기기
nonotify -모두 사실 인 경우 쿠키 알림은 자동으로 숨겨져 야합니다.
- 기본값 : 0
- 옵션 :
  - 0 = 쿠키 알림 표시
  - 1 = 쿠키 알림 숨기기
orientation -문서의 방향
- 기본값 : 세로
- 옵션 :
  - 초상화
  - 경치
pagesize -문서의 페이지 크기
- 기본값 : A4
- 옵션 :
  - A3
  - A4
  - A5
  - A6
  - B3
  - B4
  - B5
  - B6
  - 이용약관
  - 편지
password - 문서를 보호하기위한 비밀번호 할 수
- 기본값 : 비어 있음
proxy - HTTP 프록시 세부 사항 브라우저 소프트웨어는이 캡처를 만드는 데 사용해야합니다
post -보내려는 게시물 매개 변수
quality - 캡처 품질, JPG 및 WEBP의 기본 압축률은 90 %이고 GIF는 85 %입니다. 이 매개 변수는 BMP, PNG 또는 TIFF 이미지에 영향을주지 않습니다.
- 품질을 줄이면 파일 크기가 줄어들고 다운로드 시간이 줄어 듭니다.
- 기본값 : -1
- 최소 : -1
- 최대 : 100
반복 -애니메이션 GIF를 반복 할 횟수입니다.
- 기본값 : 0
- 연속 루프 : 0
- 반복하지 않음: -1
역 -참이면 애니메이션 GIF의 프레임이 반전됩니다
- 기본값 : 0
- 옵션 :
  - 0 = 애니메이션이 반향되지 않음을 나타냅니다
  - 1 = 애니메이션이 반전됨을 나타냅니다
requestas -사용하려는 사용자 에이전트의 유형
- 기본값 : 0
- 옵션 :
  - 0 = 웹 사이트의 표준 버전이 반환되어야 함을 나타냅니다.
  - 1 =는 모바일 버전 웹 사이트의 반환
  - 2 = 웹 사이트의 검색 엔진보기가 반환되어야 함을 나타냅니다.
속도 -애니메이션 GIF의 속도.
- 기본값 : 1
- 최소 : 0.2
- 최대 : 10
스타트 -변환해야하는 비디오의 시작 위치 intoa 애니메이션 GIF.
- 기본값 : 0 초
tabletoinclude -변환 할 테이블의 색인. 웹 페이지의 모든 테이블이 웹 페이지의 맨 위에서 아래로 정렬되었습니다.
- 기본값 : 1
target -이 매개 변수는 CSS 선택기 대상 웹 페이지에서 전환 될 유일한 HTML 요소 int문서에서 웹 페이지의 다른 모든 부분은 무시됩니다. 일치하는 HTML 요소가 여러 개 있으면 첫 번째 요소가 선택됩니다.
- 기본값 : 비어 있음
target -이 매개 변수는 CSS 선택기 대상 웹 페이지에서 전환 될 유일한 HTML 요소 int이미지에서는 웹 페이지의 다른 모든 부분이 무시됩니다. 일치하는 HTML 요소가 여러 개 있으면 첫 번째 요소가 선택됩니다.
- 기본값 : 비어 있음
target -웹 페이지에서 HTML을 추출하는 데 사용되는 유일한 HTML 요소의 id
- 기본값 : 비어 있음
transparent -참이면 이미지 캡처는 투명해야합니다. 이것은 png 및 tiff 이미지와 만 호환됩니다.
- 기본값 : 0
- 옵션 :
  - 0 = 불투명 이미지 만들기
  - 1 = 투명한 이미지 만들기
templateid - 추가하다 이 템플릿 문서의 머리글과 바닥 글을 지정하는 ID
- 기본값 : 비어 있음
title -PDF 문서에 제목을 제공하십시오
- 기본값 : 비어 있음
waitfor -이것은 HTML 요소를 지정합니다. CSS 선택기. 요소가 일단 캡처가 실행되는 것을 볼 수 있습니다. 일치하는 HTML 요소가 여러 개 있으면 첫 번째 요소가 선택됩니다. 이 매개 변수를 사용하면 캡처가 수행되기 전에 최대 25 초 동안 대기합니다.
width -결과 썸네일의 폭 (픽셀 단위)
- 기본값 : 출력 너비와 출력 높이가 모두 지정되지 않았거나 0이면 출력 너비와 높이가 최종 이미지 너비와 높이와 일치하고, 출력 높이가 지정되면 출력 너비가 출력 높이에 비례합니다.
- 최대 : 패키지의 최대 너비
- 전체 폭 : -1 -1를 전달하면 축소판의 너비가 줄어들지 않습니다.
width - 결과 문서의 사용자 정의 너비 단위 : mm
- 태만: 페이지 크기 폭
- 최소 : 15
폭 -결과 애니메이션 GIF의 너비 (픽셀)입니다.
- 기본값 : 180px
- 최대 : 패키지의 최대 너비
- 자동 크기 : -1 (-1를 전달하면 애니메이션 GIF 크기 조정 너비가 자동 크기 인 경우 높이와 관련하여 높이는 불가능합니다)

오류 처리

API에 대한 요청에 문제가 있는 경우 오류를 설명하는 JSON 개체가 반환됩니다. 이를 결정하는 가장 좋은 방법은 처리하기 전에 응답의 콘텐츠 유형을 확인하는 것입니다. application/json 오류가 발생했습니다. JSON에서 찾은 오류 코드는 다음을 따릅니다. 표준 코드 목록.

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