API 文档
接口地址: https://api.gugudata.com/websitetools/url2image
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/websitetools/url2image?appkey=YOUR_APPKEY&url=https%3a%2f%2fcdn.gugudata.com%2fdemo%2ffetchcontentimages%2fv1%2farticle-e65ee1f448ca5233.html&width=1400&height=250&viewportWidth=1400&viewportHeight=1080&forceReload=true&isMobile=false&isFullPage=true&isDarkMode=false
数据预览: https://www.gugudata.com/preview/url2image
接口测试: https://api.gugudata.com/websitetools/url2image/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
使用已授权的 APPKEY,兼容现有有效鉴权位置。 |
| url |
string |
是 |
无 |
公开 HTTP/HTTPS 网页地址。 |
| width |
integer |
否 |
250 |
保留现有兼容参数;viewportWidth 有值时优先使用 viewportWidth,不单独裁切或缩放图片。 |
| height |
integer |
否 |
250 |
保留现有兼容参数;viewportHeight 有值时优先使用 viewportHeight。 |
| viewportWidth |
integer |
否 |
1080 |
页面视窗宽度,实际截图尺寸优先采用该值。 |
| viewportHeight |
integer |
否 |
1080 |
页面视窗高度;整页截图的实际高度还取决于页面内容。 |
| forceReload |
boolean |
否 |
false |
为 true 时重新请求截图,不读取备用旧结果。 |
| isMobile |
boolean |
否 |
false |
是否采用现有移动设备模拟方式。 |
| isFullPage |
boolean |
否 |
false |
是否截图整个页面;false 为页面视窗。 |
| isDarkMode |
boolean |
否 |
false |
保留兼容参数,当前不改变截图的明暗模式。 |
| 参数名 |
参数类型 |
备注 |
| PNG 图片内容 |
string/binary |
成功直接返回 image/png 二进制;不是 JSON 字段。 |