接口地址:
GET /web_thumbnail?url=base64_encoded_url&width=1024&height=768&user_agent=custom_ua
参数说明:
参数 | 类型 | 必填 | 说明 |
url | string | 是 | Base64 编码的网站 URL |
width | number | 否 | 截图宽度,默认 1024 |
height | number | 否 | 截图高度,默认 768 |
user_agent | string | 否 | 自定义浏览器标识,留空使用随机指纹 |
sync | boolean | 否 | 同步模式,默认 false(异步) |
成功响应:
{
"code": 1,
"data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}
错误响应:
{
"code": 0,
"data": "",
"message": "url is not base64 encoded"
}
使用示例 (JavaScript):
// Base64 编码 URL
const url = 'https://www.example.com';
const encodedUrl = btoa(url);
// 自定义User-Agent(可选)
const userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36';
// 构建请求URL
let requestUrl = `/web_thumbnail?url=${encodedUrl}&width=1024&height=768`;
if (userAgent) {
requestUrl += `&user_agent=${encodeURIComponent(userAgent)}`;
}
// 发送请求(异步模式)
fetch(requestUrl)
.then(response => response.json())
.then(data => {
if (data.code === 1 && data.task_id) {
// 异步模式:轮询任务状态
checkTaskStatus(data.task_id);
} else if (data.code === 1 && data.data) {
// 同步模式:直接显示结果
const img = document.createElement('img');
img.src = data.data;
document.body.appendChild(img);
}
});