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

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

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

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

    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。
  • 其他要求
• HTML -转换的HTML。
  • 其他要求
  • 转换HTML时，必须使用HTTP POST。
• 键 - 你的 应用密钥.
  • 其他要求
• 回电话 -处理程序GrabzIt的URL在完成工作后应调用。
  • 通过遵循每种语言的文档来了解如何创建处理程序 ASP.NET, 爪哇岛, Node.js的, Perl的, PHP, 蟒蛇 和 红宝石.
• 习俗 -您可以与捕获关联的自定义标识符。
  • 这将与您指定的任何回调URL一起返回。
• 格式 -捕获应采用的格式。
  • 默认值：jpg
  • 选项：
    • bmp8
    • bmp16
    • bmp24
    • BMP
    • CSV
    • GIF
    • HTML
    • JPG
    • JSON
    • PDF格式
    • DOCX
    • PNG
    • 搜索引擎优化
    • 斗嘴
    • mp4
    • 网页
    • 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 -浏览器的高度（以像素为单位）。
  • 默认值：1170
  • 最大：10000
  • 全长：-1 （传递-1表示获取整个网页的截图）
• click -使用来指定HTML元素 CSS选择器 点击。 请记住，查看点击效果可能也需要延迟
  • 警告此功能目前处于测试阶段，可能无法提供一致的结果。
• country - 国家 屏幕截图/捕获应取自。
  • 默认值：当前最快的位置
  • 选项：“ SG”，“ UK”，“ US”
• coverurl -应该用作PDF封面的网页的网址
  • 默认值：空
• customwatermarkid -添加一个 习俗 watermark or 特别 watermark 到文件
  • 默认值：空
• delay -的毫秒数 等待截图之前
  • 默认值：0
  • 最大：30000
• 为期 -应该转换的视频的长度（以秒为单位） int动画GIF。
  • 默认值：包装的最大长度
• 为期 - 应记录网页的长度（以秒为单位）。
  • 默认值：10
  • 最大：30
• export - 导出网址 指定捕获也应导出到的位置。
• FPS - 每秒应捕获的帧数。
  • 默认值：10
  • 最低：0.2
  • 最大：60
• FPS - 每秒应捕获的帧数。
  • 默认值：1
  • 最低：0.2
  • 最大：10
• 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
  • 从不循环：-1
• 反转 -如果为true，则动画GIF的帧反转
  • 默认值：0
  • 选项：
    • 0 =表示将不显示动画
    • 1 =表示动画将被反转
• requestas -您希望使用的用户代理类型
  • 默认值：0
  • 选项：
    • 0 =表示应返回网站的标准版本
    • 1 =表示 手机版 网站的应退还
    • 2 =表示应返回网站的搜索引擎视图
• 速度 -动画GIF的速度。
  • 默认值：1
  • 最低：0.2
  • 最大：10
• 开始 -应该转换的视频的起始位置 int动画GIF。
  • 默认值：0秒
• 开始 - 加载后应捕获视频的开始时间（以秒为单位）。
  • 默认值：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缩放 关于其高度，如果宽度是自动调整大小，则高度不能）

用户详细信息

通过这个简单的电话即可获取您的当前帐户套餐以及剩余津贴。

    https://api.grabz.it/services/user?key=Sign in to view your Application Key

错误处理

如果您向 API 发出的请求存在问题，将返回一个 JSON 对象来解释错误。 确定这一点的最佳方法是在处理之前检查响应的内容类型，如果 application/json 发生了错误。 在 JSON 中找到的错误代码如下 标准代码列表.

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