代码示例
即复制即用,无需 SDK。
API 参数
端点: POST /api/v1/screenshots
必需
url
常用选项
fullPage, viewport, format, quality, waitUntil, delayMs, selector
同步模式约束
如果您请求 mode=sync,服务器将回退到异步模式,除非提供了 timeoutMs 且 0 < timeoutMs < 10000 并且 fullPage=false。
curl -X POST "http://api.page-ops.com/api/v1/screenshots" \
-H "Authorization: Bearer $SCREENSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'
import fetch from "node-fetch";
const resp = await fetch("http://api.page-ops.com/api/v1/screenshots", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.SCREENSHOT_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({ url: "https://example.com" })
});
console.log(await resp.json());
import os
import requests
resp = requests.post(
"http://api.page-ops.com/api/v1/screenshots",
headers={
"Authorization": f"Bearer {os.environ['SCREENSHOT_API_KEY']}",
"Content-Type": "application/json",
},
json={"url": "https://example.com"},
)
print(resp.json())
package main
import (
"bytes"
"net/http"
"os"
)
func main() {
body := []byte(`{"url":"https://example.com"}`)
req, _ := http.NewRequest("POST", "http://api.page-ops.com/api/v1/screenshots", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("SCREENSHOT_API_KEY"))
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)
}
测试场
观看完整的 API 密钥创建和截图捕获控制台演示。
提示:打开控制台亲自尝试。
演示
功能特性
大规模可靠截图所需的一切功能。
高吞吐量截图 API
• 可扩展基础设施
• 队列处理
• 可靠任务执行
快速异步任务
创建任务、轮询状态、下载结果。为高吞吐量而设计。
API 密钥认证
开发者友好的 Bearer 令牌。放心轮换密钥。
Quota + rate limit
基于计划的用量控制保护你的基础设施。
Playwright 驱动
为真实页面提供现代浏览器渲染。
多租户工作空间
通过工作空间隔离分离环境和团队。
简单集成
单个 HTTP 请求。适用于 CI、cron 或你的后端。
使用案例
网站监控
通过定时捕获跟踪布局损坏和服务中断。
SEO 截图
审核重要页面并保存历史快照。
社交媒体预览
自动生成预览图片和 OG 资源。
视觉回归测试
在 CI 中对比截图以在发布前捕获 UI 错误。
工作原理
1) API 请求
POST URL(和选项)来创建截图任务。
2) 云浏览器
我们在隔离的浏览器环境中渲染它。
3) 截图结果
轮询状态并在准备就绪时获取最终资源。
常见问题
你们支持异步任务吗?
支持。创建任务然后查询状态直到完成。
速率限制如何工作?
限制基于计划。超出限制返回 HTTP 429。
配额呢?
配额按滚动周期执行。超出返回 HTTP 402。
你们收取超额费用吗?
不。使用量每月重置。
如果我达到限制会怎样?
请求将暂停到下一个计费周期。
你们支持全页截图吗?
支持(付费计划)。
我可以轮换 API 密钥吗?
可以。在控制台中创建和轮换密钥。