获取网站截图 API 使用说明
基于绿夏网络 API 接口站 · 将指定网页渲染为图片,支持直接出图、Base64 与 JSON
在展示外链预览、资源列表缩略图或运营素材时,常常需要「把某个网页变成一张图」。绿夏网络提供的截图接口用 GET 请求传入目标页面地址,由服务端生成截图;默认返回图片流,也可按需返回 Base64 或 JSON(含 Base64)。
官方文档入口:https://api.lxwl520.cn/snapshot.html

一、接口能做什么
- 整页/站点预览:文章、导航、后台里展示目标站当前画面
- 减少自建成本:不必自备无头浏览器集群,用地址拼参即可调用
- 多种返回形态:除直接图片外,可加参数拿到 Base64 或 JSON,便于存库或二次处理
二、请求说明(速查)
| 项目 | 说明 |
|---|---|
| 接口地址 | https://api.lxwl520.cn/api/snapshot.php |
| 请求方式 | GET |
| 默认返回 | 图片(IMG),可直接作为图片 URL 使用 |
| 文档参考 | 参数取值与更新以 官网说明 为准 |
参数说明
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
url |
是 | String | 目标页面的完整链接(必传) |
base64 |
否 | String | 传参后返回 Base64 格式的图片数据(具体传值规则见官网) |
json |
否 | String | 传参后返回 JSON,内容包含 Base64 等字段(具体结构见官网或实测) |
三、请求示例
文档示例(将 url= 换成你的目标页):
https://api.lxwl520.cn/api/snapshot.php?url=https://www.lxwl520.cn
若还需 Base64 或 JSON,一般在后面追加查询参数(写法以官网为准),例如:
https://api.lxwl520.cn/api/snapshot.php?url=https%3A%2F%2Fwww.example.com&base64=1
https://api.lxwl520.cn/api/snapshot.php?url=https%3A%2F%2Fwww.example.com&json=1
四、在页面与程序里怎么用
- 网页直接展示:默认返回图片时,可与外链图片一样写入
<img src="接口完整地址">。 - 只拿 Base64:适合不落盘、拼
data:image/png;base64,...或写入数据库字段。 - JSON 模式:适合前后端约定字段、与其它接口统一解析方式。
官网写明「返回数据:根据所需返回」,因此实际 MIME 类型与字段请以联调结果或最新文档为准。
五、接入时注意什么
- 合规与版权:截图内容来自第三方站点,展示前请遵守目标站服务条款与本地法规。
- 性能与限流:截图比小图标更耗资源,宜缓存结果、控制刷新频率。
- 安全:若服务端代用户传
url,须校验协议与域名,避免 SSRF(内网探测)风险。 - 失败兜底:目标站超时、反爬或接口异常时,准备占位图或提示文案。
六、小结
| 需求 | 做法 |
|---|---|
| 要一张网页预览图 | GET snapshot.php?url=页面完整地址 |
| 要 Base64 / 结构化数据 | 在请求中增加 base64 或 json 参数(见官网) |
暂无评论,快来抢沙发吧~