使用我们的RESTful屏幕截图API获取网站屏幕截图

GrabzIt的REST API允许您使用RESTful技术完全捕获URL或HTML。在开始之前，请根据您的用例仔细阅读以下注意事项，我们的其他API解决方案之一可能更合适。

-某些功能（例如合并和加密捕获）无法通过此REST API使用。要使用这些功能，您将需要使用其他功能 API库
-不要在客户端使用此API，因为它将暴露您的应用程序密钥！而是使用 JavaScript API

要开始使用，只需从下面的过滤器中选择要执行的操作，然后将显示可用的参数以及一个基本示例。

你想让我做什么？

提出要求时，请确保所有参数值是URL编码的。

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

转换HTML时，所有参数都必须 张贴在请求正文中 作为键值对。确保所有参数值都经过URL编码。

    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

然后将在 HTTP 响应中返回捕获。此类捕获还可以使用以下附加选项，除了标记为必需的选项以外，所有其他选项都是可选的。在测试 API 功能时，我们建议使用邮差简化流程。

网址 -捕获的URL。
- 其他要求
HTML -转换的HTML。
- 其他要求
- 转换HTML时，必须使用HTTP POST。
键 - 你的应用密钥.
- 其他要求
回电话 -处理程序GrabzIt的URL在完成工作后应调用。
- 通过遵循每种语言的文档来了解如何创建处理程序 ASP.NET, Java的, Node.js的, Perl的, PHP, 蟒蛇以及红宝石.
习俗 -您可以与捕获关联的自定义标识符。
- 这将与您指定的任何回调URL一起返回。
格式 -捕获应采用的格式。
- 默认值：jpg
- 选项：
  - bmp8
  - bmp16
  - bmp24
  - BMP
  - CSV
  - GIF
  - HTML
  - JPG
  - JSON
  - PDF格式
  - DOCX
  - PNG
  - 斗嘴
  - 网页
  - XLSX
address -在其中执行HTML代码的URL。如果要转换的HTML使用相对于资源（例如CSS和图像）的相对URL，则很有用。
- 默认值：空
background -如果为true，则网页背景应包含在PDF中
- 默认值：1
- 选项：
  - 0 =表示PDF文档不应包含网页背景
  - 1 =表示PDF文档应包含网页背景
background -如果为true，则网页的背景图片应包含在DOCX中
- 默认值：1
- 选项：
  - 0 =表示DOCX文档不应包含网页背景图片
  - 1 =表示DOCX文档应包含网页背景图像
bwidth -浏览器的宽度（以像素为单位）
- 警告此功能目前处于测试阶段，可能无法提供一致的结果。
- 默认值：1366
- 最大：10000
- 自动宽度：-1 （传递-1表示浏览器的宽度匹配文档的宽度）
bheight -浏览器的高度（以像素为单位）。
- 默认值：768
- 最大：10000
- 全长：-1 （传递-1表示获取整个网页的截图）
click -使用来指定HTML元素 CSS选择器点击。请记住，查看点击效果可能也需要延迟
- 警告此功能目前处于测试阶段，可能无法提供一致的结果。
country - 国家屏幕截图/捕获应取自。
- 默认值：当前最快的位置
- 选项：“ SG”，“ UK”，“ US”
coverurl -应该用作PDF封面的网页的网址
- 默认值：空
customwatermarkid -添加一个习俗 watermark 到文件
- 默认值：空
delay -的毫秒数等待截图之前
- 默认值：0
- 最大：30000
为期 -应该转换的视频的长度（以秒为单位） int动画GIF。
- 默认值：包装的最大长度
export - 导出网址指定捕获也应导出到的位置。
FPS -每秒应从视频中捕获的帧数。
- 默认值：10
- 最低：0.2
- 最大：60
hd -如果图像真实捕获将是高清这会使图像尺寸增加一倍。
- 默认值：0
- 选项：
  - 0 =创建高清图像
  - 1 =创建高清图像
height -结果缩略图的高度（以像素为单位）
- 默认值：如果未同时指定输出宽度和输出高度或为0，则输出宽度和高度将与最终图像的宽度和高度相匹配；如果指定了输出宽度，则输出高度将与输出宽度成比例
- 最大：包装的最大高度
- 全高：-1 （传递-1表示缩略图的高度不会减小）
height - 自定义文件高度单位为毫米
- 默认：页面大小高度
- 最低：15
高度 -生成的动画GIF的高度（以像素为单位）。
- 默认值：120px
- 最大：包装的最大高度
- 自动调整大小：-1 （传递-1表示动画GIF缩放关于宽度，如果要自动调整高度，则宽度不能）
hide - CSS选择器要隐藏网页中一个或多个HTML元素中的一个，以指定要隐藏的多个HTML元素，每个选择器用逗号分隔。
- 默认值：空
includealltables -如果为true，则将提取网页上的所有表格，并且每个表格都显示在单独的电子表格中。
- 仅适用于XLSX格式
- 默认值：0
- 选项：
  - 0 =表示将不提取所有表
  - 1 =表示将提取所有表
includeheadernames -如果表中包含真实的标题名称
- 默认值：1
- 选项：
  - 0 =表示标题名称将不包含在表中
  - 1 =表示标题名称将包含在表中
includeimages -如果为true，则网页图像应包含在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 -如果为true，则通常会找到所有 Cookie通知应自动隐藏.
- 默认值：0
- 选项：
  - 0 =显示Cookie通知
  - 1 =隐藏Cookie通知
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
反转 -如果为true，则动画GIF的帧反转
- 默认值：0
- 选项：
  - 0 =表示将不显示动画
  - 1 =表示动画将被反转
requestas -您希望使用的用户代理类型
- 默认值：0
- 选项：
  - 0 =表示应返回网站的标准版本
  - 1 =表示手机版网站的应退还
  - 2 =表示应返回网站的搜索引擎视图
速度 -动画GIF的速度。
- 默认值：1
- 最低：0.2
- 最大：10
开始 -应该转换的视频的起始位置 int动画GIF。
- 默认值：0秒
tabletoinclude -要转换的表的索引，即网页中的所有表从网页顶部到底部的顺序
- 默认值：1
target -此参数指定 CSS选择器目标网页上唯一要翻转的HTML元素 int在文档中，将忽略网页的所有其他部分。如果有多个匹配的HTML元素，则选择第一个。
- 默认值：空
target -此参数指定 CSS选择器唯一的 HTML元素在将要打开的目标网页上 int在图像中，将忽略网页的所有其他部分。如果有多个匹配的HTML元素，则选择第一个。
- 默认值：空
target -网页中唯一可用于从中提取表格的HTML元素的ID
- 默认值：空
transparent -如果为true 图像捕获应该是透明的。这仅与png和tiff图像兼容。
- 默认值：0
- 选项：
  - 0 =创建非透明图像
  - 1 =创建透明图像
templateid -添加一个模板指定文档的页眉和页脚的ID
- 默认值：空
title -提供PDF文档的标题
- 默认值：空
waitfor -使用来指定HTML元素 CSS选择器。一旦元素是可见捕获已执行。如果有多个匹配的HTML元素，则选择第一个。使用此参数时，将最多等待25秒才能执行捕获。
width -结果缩略图的宽度（以像素为单位）
- 默认值：如果未同时指定输出宽度和输出高度或为0，则输出宽度和高度将与最终图像的宽度和高度相匹配；如果指定了输出高度，则输出宽度将与输出高度成比例
- 最大：包装的最大宽度
- 全宽：-1 （传递-1表示缩略图的宽度不会减小）
width - 自定义文档宽度单位为毫米
- 默认：页面大小宽度
- 最低：15
宽度 -生成的动画GIF的宽度（以像素为单位）。
- 默认值：180px
- 最大：包装的最大宽度
- 自动调整大小：-1 （传递-1表示动画GIF缩放关于其高度，如果宽度是自动调整大小，则高度不能）