Инструменты для захвата и конвертирования Интернета

GrabzIt Клиент с Node.jsNode.js API

Описание

Этот класс обрабатывает все коммуникации с веб-сервисами GrabzIt.

Публичные методы

get_result (ID)

Этот метод возвращает сам скриншот. Если ничего не возвращено, значит что-то пошло не так или скриншот еще не готов.

параметры

  • id - уникальный идентификатор скриншота
    • необходимые

url_to_animation(URL, опционы)

Укажите URL-адрес онлайн-видео, которое необходимо преобразовать intанимированный GIF.

параметры

  • url - URL видео онлайн для конвертации intо анимированный GIF
    • необходимые
    • Принимает Vimeo и YouTube видео URL
      • Предупреждение о анимации видео Vimeo и YouTube зависит от третьей стороны и, следовательно, может не дать согласованных результатов
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании анимированного GIF.

Возвращаемое значение

аннулировать

Параметры анимации

Все параметры доступны при создании анимированного GIF.

  • customId - пользовательский идентификатор, который вы можете передать через анимированный GIF веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • width - ширина получаемого анимированного GIF в пикселях.
    • По умолчанию: 180px
    • Максимум: максимальная ширина для упаковки
    • Авто-размер: -1 (передача -1 означает, что ширина анимированный GIF масштабируется по отношению к его высоте, если ширина автоматически измеряется, высота не может)
  • height - высота получаемого анимированного GIF в пикселях.
    • По умолчанию: 120px
    • Максимум: максимальная высота упаковки
    • Авто-размер: -1 (передача -1 означает, что высота анимированный GIF масштабируется по отношению к его ширине, если высота автоматически измеряется, ширина не может)
  • start - начальная позиция видео, которое должно быть преобразовано intанимированный GIF.
    • По умолчанию: секунды 0
  • duration - продолжительность видео в секундах, которое должно быть конвертировано intанимированный GIF.
    • По умолчанию: максимальная длина пакета
  • speed - скорость анимированного GIF.
    • По умолчанию: 1
    • Минимум: 0.2
    • Максимум: 10
  • framesPerSecond - количество кадров в секунду, которое должно быть снято с видео.
    • По умолчанию: 10
    • Минимум: 0.2
    • Максимум: 60
  • repeat - количество циклов анимированного GIF.
    • По умолчанию: 0
    • Цикл непрерывно: 0
  • reverse - если true, кадры анимированного GIF меняются местами
    • По умолчанию: false
  • customWaterMarkId - добавить собственный водяной знак в анимированный GIF
    • По умолчанию: пусто
  • quality - качество возвращаемого изображения, который имеет сжатие по умолчанию 85%.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна анимированный GIF должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

Пример опций

{
    'width':250,
    'height':250,
    'speed':2
}

url_to_image(URL, опционы)

Определяет URL, который должен быть преобразован intскриншот изображения.

параметры

  • url - URL, из которого должен быть сделан снимок экрана
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании снимка экрана.

Возвращаемое значение

аннулировать

html_to_image(HTML, опционы)

Определяет HTML, который должен быть преобразован intoa изображение.

параметры

  • HTML - HTML для преобразования intизображение
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании изображения.

Возвращаемое значение

аннулировать

file_to_image(дорожка, опционы)

Определяет файл HTML, который должен быть преобразован intoa изображение.

параметры

  • путь - путь к файлу HTML-файла для преобразования intизображение
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании изображения.

Возвращаемое значение

аннулировать

Параметры изображения

Все опции доступны при создании снимков.

  • customId - пользовательский идентификатор, который вы можете передать на веб-сервис скриншотов. Он будет возвращен с указанным вами обратным URL-адресом.
    • По умолчанию: пусто
  • browserWidth - ширина браузера в пикселях
    • По умолчанию: 1024
    • Максимум: 10000
  • browserHeight - высота браузера в пикселях
    • По умолчанию: 768
    • Максимум: 10000
    • Полная длина: -1 (пропуск -1 означает, что взят снимок всей веб-страницы)
  • width - ширина получаемого эскиза в пикселях
    • По умолчанию: максимально возможное соотношение ширины браузера, которое соответствует максимальной ширине для пакета пользователя
    • Максимум: максимальная ширина для упаковки
    • Полная ширина: -1 (пропуск -1 означает, что ширина эскиза не уменьшается)
  • height - высота получаемого эскиза в мм
    • По умолчанию: максимально возможное соотношение высоты браузера, которое соответствует максимальной высоте для пакета пользователя
    • Максимум: максимальная высота упаковки
    • Полная высота: -1 (пропуск -1 означает, что высота эскиза не уменьшается)
  • format - формат скриншота должен быть в.
    • По умолчанию: "JPG"
    • Опции: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • targetElement - CSS селектор единственного HTML-элемента на целевой веб-странице, который должен быть повернут into Скриншот, все остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
  • customWaterMarkId - добавить собственный водяной знак на изображение
    • По умолчанию: пусто
  • quality - качество возвращаемого изображения, В настоящее время это влияет только на изображения JPG, сжатие по умолчанию которых составляет 85%.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • transparent - если правда захват изображения должен быть прозрачным, Это совместимо только с изображениями PNG и TIFF.
    • По умолчанию: false
  • hd - если верно изображение захват будет в высоком разрешении это удваивает размер изображения.
    • По умолчанию: false
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • post - определяет запрос HTTP Poststring, Каждое имя и значение в запросеstring нужно будет закодировать URL. Использование этой опции заставит GrabzIt выполнить сообщение HTTP.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

Пример опций

{
    'width':500,
    'height':500
}

url_to_rendered_html(URL, опционы)

Определяет URL, который должен быть преобразован intо рендеринга HTML.

параметры

  • url - URL-адрес, из которого должен быть выполнен визуализированный HTML
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании отрисованного HTML.

Возвращаемое значение

аннулировать

html_to_rendered_html(HTML, опционы)

Определяет HTML, который должен быть преобразован intо рендеринга HTML.

параметры

  • HTML - HTML для преобразования intо рендеринг HTML
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании визуализированного HTML.

Возвращаемое значение

аннулировать

file_to_rendered_html(дорожка, опционы)

Определяет файл HTML, который должен быть преобразован intо рендеринга HTML.

параметры

  • путь - путь к файлу HTML-файла для преобразования intо рендеринг HTML
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании визуализированного HTML.

Возвращаемое значение

аннулировать

Параметры HTML

Все варианты доступны при создание визуализированных захватов HTML.

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • browserWidth - ширина браузера в пикселях
    • По умолчанию: 1024
    • Максимум: 10000
  • browserHeight - высота браузера в пикселях
    • По умолчанию: 768
    • Максимум: 10000
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • waitForElement - CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • post - определяет запрос HTTP Poststring, Каждое имя и значение в запросеstring нужно будет закодировать URL. Использование этой опции заставит GrabzIt выполнить сообщение HTTP.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

Пример опций

{
    'country':'SG',
    'delay':5000
}

url_to_pdf(URL, опционы)

Определяет URL, который должен быть преобразован intoa PDF.

параметры

  • URL - URL, который должен быть преобразован intoa PDF
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании PDF.

Возвращаемое значение

аннулировать

html_to_pdf(HTML, опционы)

Определяет HTML, который должен быть преобразован intoa PDF.

параметры

  • HTML - HTML для преобразования intoa PDF
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании PDF.

Возвращаемое значение

аннулировать

file_to_pdf(дорожка, опционы)

Определяет файл HTML, который должен быть преобразован intoa PDF.

параметры

  • путь - путь к файлу HTML-файла для преобразования intoa PDF
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании PDF.

Возвращаемое значение

аннулировать

Параметры PDF

Все параметры, доступные при создании захвата PDF.

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • includeBackground - если true, фон веб-страницы должен быть включен в скриншот
    • По умолчанию: правда
  • pagesize - размер страницы PDF
    • По умолчанию: "A4"
    • Опции: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
  • orientation - ориентация PDF документа
    • По умолчанию: «Портрет»
    • Опции: «Портрет», «Пейзаж»
  • cssMediaType - CSS Media Тип документа PDF
    • По умолчанию: «Экран»
    • Опции: «Экран», «Прint"
  • includeLinks - true, если ссылки должны быть включены в PDF
    • По умолчанию: правда
  • includeOutline - правда, если PDF закладки должны быть включены
    • По умолчанию: false
  • title - укажите название документа PDF
    • По умолчанию: пусто
  • coverUrl - URL веб-страницы, которая должна использоваться в качестве обложки для PDF
    • По умолчанию: пусто
  • marginTop - поле в миллиметрах, которое должно отображаться в верхней части страницы документа PDF
    • По умолчанию: 10
  • marginLeft - поле в миллиметрах, которое должно появиться слева от страницы документа PDF
    • По умолчанию: 10
  • marginBottom - поле в миллиметрах, которое должно отображаться внизу страницы документа PDF
    • По умолчанию: 10
  • marginRight - поле в миллиметрах, которое должно отображаться справа от документа PDF
    • По умолчанию: 10
  • browserWidth - ширина браузера в пикселях
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: 1024
    • Максимум: 10000
    • Авто Ширина: -1 (передача -1 означает, что ширина браузера соответствует ширине PDF-документа)
  • pageWidth - пользовательская ширина полученного PDF в мм
  • pageHeight - пользовательская высота получаемого PDF в мм
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
  • templateId - добавить шаблон Идентификатор, который определяет верхний и нижний колонтитулы документа PDF
    • По умолчанию: пусто
  • targetElement - CSS селектор из единственного HTML-элемент на целевой веб-странице, которую нужно перевернуть intoa PDFвсе остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • customWaterMarkId - добавить собственный водяной знак на каждую страницу документа PDF
    • По умолчанию: пусто
  • quality - качество возвращаемого PDF, По умолчанию используется рекомендуемое качество для PDF.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • post - определяет запрос HTTP Poststring, Каждое имя и значение в запросеstring нужно будет закодировать URL. Использование этой опции заставит GrabzIt выполнить сообщение HTTP.
    • По умолчанию: пусто
  • templateVariables - определяет пользовательский шаблон параметр и значение как запросstring, Каждое имя и значение в запросеstring нужно будет закодировать URL.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто
  • mergeId - идентификатор захвата, который должен быть объединены в начале нового документа PDF
    • По умолчанию: пусто
  • password - пароль для защиты PDF документа с
    • По умолчанию: пусто

Пример опций

{
    'pagesize':'A5',
    'includeLinks':true
}

url_to_docx(URL, опционы)

Определяет URL, который должен быть преобразован intооо

параметры

  • URL - URL, который должен быть преобразован intoa DOCX
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании DOCX.

Возвращаемое значение

аннулировать

html_to_docx(HTML, опционы)

Определяет HTML, который должен быть преобразован intооо

параметры

  • HTML - HTML для преобразования intoa DOCX
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании DOCX.

Возвращаемое значение

аннулировать

file_to_docx(дорожка, опционы)

Определяет файл HTML, который должен быть преобразован intооо

параметры

  • путь - путь к файлу HTML-файла для преобразования intoa DOCX
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые следует использовать при создании DOCX.

Возвращаемое значение

аннулировать

Опции DOCX

Все опции, доступные при создании захватов DOCX.

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали.
    • По умолчанию: пусто
  • includeBackground - если true, фоновые изображения веб-страницы должны быть включены в DOCX
    • По умолчанию: правда
  • pagesize - размер страницы DOCX
    • По умолчанию: "A4"
    • Опции: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Letter"
  • orientation - ориентация документа DOCX
    • По умолчанию: «Портрет»
    • Опции: «Портрет», «Пейзаж»
  • includeLinks - true, если ссылки должны быть включены в DOCX
    • По умолчанию: правда
  • includeImages - если истина, изображения веб-страницы должны быть включены в DOCX
    • По умолчанию: правда
  • title - предоставить заголовок документа DOCX
    • По умолчанию: пусто
  • marginTop - поле в миллиметрах, которое должно отображаться в верхней части страницы документа DOCX
    • По умолчанию: 10
  • marginLeft - поле в миллиметрах, которое должно появиться слева от страницы документа DOCX
    • По умолчанию: 10
  • marginBottom - поле в миллиметрах, которое должно отображаться внизу страницы документа DOCX
    • По умолчанию: 10
  • marginRight - поле в миллиметрах, которое должно отображаться справа от документа DOCX
    • По умолчанию: 10
  • browserWidth - ширина браузера в пикселях
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: 1024
    • Максимум: 10000
    • Авто Ширина: -1 (передача -1 означает, что ширина браузера соответствует ширине документа DOCX)
  • pageWidth - пользовательская ширина результирующего DOCX в мм
  • pageHeight - Пользовательская высота результирующего DOCX в мм
  • delay - количество миллисекунд до подождите, прежде чем сделать скриншот
    • По умолчанию: 0
    • Максимум: 30000
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
  • templateId - добавить шаблон Идентификатор, который определяет верхний и нижний колонтитулы документа DOCX
    • По умолчанию: пусто
  • targetElement - CSS селектор единственного HTML-элемента на целевой веб-странице, который должен быть повернут into DOCX, все остальные части веб-страницы игнорируются. Если есть несколько совпадающих элементов HTML, выбирается первый
    • По умолчанию: пусто
  • hideElement - CSS селекторы один или несколько элементов HTML на веб-странице, которые нужно скрыть, чтобы указать несколько элементов HTML для скрытия, разделяя каждый селектор запятой
    • По умолчанию: пусто
  • waitForElement - CSS селекторы элемента HTML на веб-странице, которая должен быть виден до выполнения захвата
    • По умолчанию: пусто
  • quality - качество возвращаемого DOCX, Качество изображений по умолчанию в DOCX - 85%.
    • Снижение качества уменьшит размер файла и сократит время загрузки.
    • По умолчанию: -1
    • Минимум: -1
    • Максимум: 100
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • noAds - если правда реклама должна быть автоматически скрыта.
    • По умолчанию: false
  • noCookieNotifications - если правда, все обычно встречаются уведомления о файлах cookie должны быть автоматически скрыты.
    • По умолчанию: false
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • post - определяет запрос HTTP Poststring, Каждое имя и значение в запросеstring нужно будет закодировать URL. Использование этой опции заставит GrabzIt выполнить сообщение HTTP.
    • По умолчанию: пусто
  • templateVariables - определяет пользовательский шаблон параметр и значение как запросstring, Каждое имя и значение в запросеstring нужно будет закодировать URL.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто
  • mergeId - идентификатор захвата, который должен быть объединены в начале нового документа DOCX
    • По умолчанию: пусто
  • password - пароль для защиты документа DOCX с
    • По умолчанию: пусто

Пример опций

{
    'pagesize':'A5',
    'includeLinks':true
}

url_to_table(URL, опционы)

Определяет URL, из которого должны быть извлечены таблицы HTML.

параметры

  • url - URL для извлечения HTML-таблиц из
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

html_to_table(HTML, опционы)

Определяет HTML, из которого должны быть извлечены таблицы HTML.

параметры

  • html - HTML-код для извлечения HTML-таблиц.
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

file_to_table(дорожка, опционы)

Указывает файл HTML, из которого должны быть извлечены таблицы HTML.

параметры

  • путь - путь к файлу HTML, из которого извлекаются таблицы HTML.
    • необходимые
  • опционы - объект JSON, который определяет любые специальные параметры, которые будут использоваться при преобразовании таблицы HTML.

Возвращаемое значение

аннулировать

параметры таблицы

Все параметры доступны при преобразовании таблиц HTML в CSV, XLSX или JSON.

  • customId - пользовательский идентификатор, который вы можете передать через веб-сервис. Это будет возвращено с URL-адресом обратного вызова, который вы указали
    • По умолчанию: пусто
  • tableNumberToInclude - индекс таблицы, которую нужно преобразовать, если все таблицы на веб-странице упорядочены сверху вниз по веб-странице
    • По умолчанию: 1
  • format - формат таблицы должен быть в
    • По умолчанию: "CSV"
    • Опции: "CSV", "JSON", "XLSX"
  • includeHeaderNames - если в таблицу будут включены истинные имена заголовков
    • По умолчанию: правда
  • includeAllTables - если true, вся таблица на веб-странице будет извлечена, и каждая таблица появится в отдельном листе электронной таблицы. Доступно только с форматом XLSX
    • По умолчанию: false
  • targetElement - идентификатор единственного HTML-элемента на веб-странице, который должен использоваться для извлечения таблиц из
    • По умолчанию: пусто
  • requestAs - тип пользовательского агента, который вы хотите использовать
    • По умолчанию: 0
    • Опции:
      • 0 = указывает, что должен использоваться пользовательский агент стандартного браузера
      • 1 = указывает, что должен использоваться пользовательский агент мобильного браузера
      • 2 = указывает, что должен использоваться пользовательский агент поисковой системы
  • country - страна скриншот должен быть взят из.
    • Предупреждение: эта функция в настоящее время находится в стадии бета-тестирования и может не давать согласованных результатов.
    • По умолчанию: текущее самое быстрое местоположение
    • Варианты: «SG», «UK», «US»
  • exportUrl - URL экспорта это указывает, куда захват должен быть экспортирован тоже
    • По умолчанию: пусто
  • encryptionKey - если указан базовый ключ шифрования AES в кодировке 64, ваш захват шифруется при его создании. Рекомендуется использовать создать метод ключа шифрования создать ключ и методы дешифрования расшифровать зашифрованный захват, как показано в этот пример.
    • По умолчанию: пусто
  • post - определяет запрос HTTP Poststring, Каждое имя и значение в запросеstring нужно будет закодировать URL. Использование этой опции заставит GrabzIt выполнить сообщение HTTP.
    • По умолчанию: пусто
  • address - URL для выполнения кода HTML. Может быть полезен, если конвертируемый HTML использует относительные URL для таких ресурсов, как CSS и изображения.
    • По умолчанию: пусто
  • proxy - подробности HTTP прокси программное обеспечение браузера должно использовать для создания этого захвата
    • По умолчанию: пусто

Пример опций

{
    'format':'xlsx',
    'includeHeaderNames':true
}
Использование опции callBackUrl является рекомендуемым способом сохранения файла.

save(callBackUrl, oncomplete)

Save результат асинхронно и возвращает уникальный идентификатор, который можно использовать для получения снимка экрана с get_result метод.

параметры

  • callBackURL - обработчик Служба GrabzIt должна позвонить после завершения своей работы
  • oncomplete (error, id) - функция обратного вызова, которая вызывается при получении идентификатора снимка экрана.

save_to(saveToFile, завершено)

Save результат синхронно без использования URL обратного вызова.

параметры

  • saveToFile - путь к файлу, захват которого будет saved, когда он будет завершен
  • oncomplete (ошибка, данные) - функция обратного вызова, которая вызывается при загрузке скриншота. Параметр данных содержит байты снимков экрана.

get_status(идентификатор, незавершенный)

Получить текущий статус скриншота GrabzIt.

параметры

  • id - уникальный идентификатор скриншота
    • необходимые
  • OnComplete (ошибка, статус) - функция обратного вызова, которая вызывается при получении статуса скриншота.
    • необходимые

get_cookies(домен, незавершенный)

Получить все куки, которые GrabzIt использует для определенного домена. Это может также включать определенные пользователем файлы cookie.

параметры

  • домен - домен для возврата куки
    • необходимые
  • OnComplete (ошибка, печенье) - функция обратного вызова, которая вызывается при получении файлов cookie.
    • необходимые

set_cookie (имя, домен, параметры, oncomplete)

Устанавливает новый пользовательский файл cookie для GrabzIt, если пользовательский файл cookie имеет то же имя и домен, что и глобальный файл cookie, глобальный файл cookie переопределяется.

Это может быть полезно, если функциональность веб-сайта контролируется куки-файлами.

параметры

  • name - имя куки для установки
    • необходимые
  • домен - домен веб-сайта, для которого устанавливается файл cookie
    • необходимые
  • опционы
    • value - значение куки
    • путь - путь к сайту, к которому относится cookie
    • httponly - если true, cookie может использоваться только с протоколом HTTP
    • expires - определяет, когда истекает срок действия cookie. Передайте нулевое значение, если срок действия файла cookie не истек
    {
    'value':'me@example.com',
    'httponly':false
}
  • oncomplete (ошибка, успех) - функция обратного вызова, которая вызывается при установке cookie. Параметр success равен true, если cookie успешно установлен, в противном случае - false

delete_cookie (имя, домен, незавершенный)

Удалить пользовательский файл cookie или заблокировать использование глобального файла cookie

параметры

  • name - имя куки для удаления
    • необходимые
  • домен - домен сайта для удаления куки
    • необходимые
  • oncomplete (ошибка, успех) - функция обратного вызова, которая вызывается при установке cookie. Параметр успеха равен true, если cookie удаляется, в противном случае - false.

get_watermarks ()

Получите все ваши загруженные пользовательские водяные знаки

параметры

  • OnComplete (ошибка, водяные знаки) - функция обратного вызова, которая вызывается при получении водяных знаков. Параметр водяного знака содержит массив водяных знаков.
    • необходимые

get_watermark (идентификатор, незавершенный)

Вернуть свой водяной знак, который соответствует указанному идентификатору

параметры

  • идентификатор - идентификатор определенного пользовательского водяного знака, который вы хотите просмотреть
    • необходимые
  • OnComplete (ошибка, водяные знаки) - функция обратного вызова, которая вызывается при получении водяного знака. Параметр водяных знаков содержит массив водяных знаков.
    • необходимые

add_watermark (идентификатор, путь, xpos, ypos, oncomplete)

Добавить новый пользовательский водяной знак

параметры

  • идентификатор - идентификатор, который вы хотите присвоить пользовательскому водяному знаку. Важно, чтобы этот идентификатор был уникальным.
    • необходимые
  • путь - абсолютный путь водяного знака на вашем сервере. Например, C: /watermark/1.png
    • необходимые
  • xpos - горизонтальная позиция, в которой вы хотите, чтобы скриншот появлялся в
    • необходимые
    • Опции:
      • Слева = 0
      • Центр = 1
      • Право = 2
  • ypos - вертикальная позиция, в которой вы хотите, чтобы скриншот появлялся в
    • необходимые
    • Опции:
      • Top = 0
      • Средний = 1
      • Низ = 2
  • oncomplete (ошибка, успех) - функция обратного вызова, которая вызывается при добавлении водяного знака. Параметр success равен true, если водяной знак был успешно добавлен, в противном случае - false.
    • необходимые

delete_watermark (идентификатор, незавершенный)

Удалить пользовательский водяной знак

параметры

  • идентификатор - идентификатор пользовательского водяного знака, который вы хотите удалить
    • необходимые
  • oncomplete (ошибка, успех) - функция обратного вызова, которая вызывается при удалении водяного знака. Параметр success равен true, если водяной знак был успешно удален.
    • необходимые

set_local_proxy (значение)

Этот метод позволяет локальный прокси-сервер использоваться для всех запросов.

параметры

  • значение - URL-адрес, который может включать порт прокси-сервера, если требуется. Предоставление нулевого значения удалит любой ранее установленный прокси
    • необходимые

USE_SSL (значение)

Определяет, если запросы к GrabzIt's API должен использовать SSL

параметры

  • значение - если true, все запросы к API GrabzIt будут использовать SSL
    • необходимые

create_encryption_key ()

Создайте криптографически безопасный базовый ключ шифрования 64 длиной 44.

расшифровать (данные, ключ)

Расшифруйте зашифрованный захват, используя предоставленный ключ шифрования.

параметры

  • путь - путь зашифрованного захвата
    • необходимые
  • ключ - ключ шифрования
    • необходимые

decrypt_file (путь, ключ, oncomplete)

Расшифруйте зашифрованный захват, используя предоставленный ключ шифрования.

параметры

  • путь - путь зашифрованного захвата
    • необходимые
  • ключ - ключ шифрования
    • необходимые
  • oncomplete (error) - функция обратного вызова, которая вызывается при расшифровке файла.

Классы результатов

печенье

Публичные переменные

  • name - имя куки
  • value - значение cookie
  • домен - домен, для которого установлен файл cookie
  • путь - путь к домену, к которому применяется этот файл cookie.
  • httponly - если этот файл cookie действителен только при просмотре веб-сайта по протоколу HTTP.
  • срок действия истекает - дата истечения срока действия этого cookie
  • type - тип куки это
    • Опции:
      • Global - это глобальный файл cookie, созданный GrabzIt
      • Local - это локальный файл cookie, установленный вами
      • Переопределено - глобальный файл cookie, который был переопределен вами

Статус

Класс, представляющий текущий статус скриншота.

Публичные переменные

  • обработка - если true, скриншот все еще обрабатывается.
  • cached - если true, снимок экрана был обработан и в настоящее время кэширован.
  • expired - если true, скриншот больше не находится в системе GrabzIt.
  • сообщение - сообщение об ошибке, возвращаемое системой.

WaterMark

Этот класс представляет пользовательские водяные знаки, хранящиеся в GrabzIt

Публичные переменные

  • идентификатор - идентификатор водяного знака
  • format - формат изображения водяного знака
  • xPosition - позиция x, на которой появляется водяной знак на скриншоте
    • Опции:
      • Слева = 0
      • Центр = 1
      • Право = 2
  • yPosition - y-позиция, в которой появляется водяной знак на скриншоте
    • Опции:
      • Top = 0
      • Средний = 1
      • Низ = 2
Условия и Положения
Политику Конфиденциальности
GrabzIt Соглашение об обработке данных
Соглашение об уровне обслуживания
© GrabzIt® 2020
АнглийскийКитайский (упрощенное письмо)ФранцузскийНемецкийхиндиРусскийИспанский