skyvora SERP 打开控制台
Search infrastructure · API preview

让搜索数据，
可靠地抵达你的产品。

Skyvora SERP 提供清晰的搜索接口接入与服务内并发诊断。
连接你的 API Key，查看真实服务状态与测试报告。

进入控制台 阅读 API 文档
搜索引擎接入状态：尚未接通 · 当前不返回模拟搜索结果
A PRACTICAL WORKSPACE

从服务连通性开始，
再验证并发表现。

每个状态和数字都来自当前服务响应。没有连接 Key 时，我们会明确告诉你下一步。

Skyvora SERP / WorkspaceAPI 工具台
连接状态并发测试运行报告
连接后查看你的服务数据

此处展示 API 实测状态、任务进度和持久化报告。

现在连接
接口数据按需读取当前没有预置或演示数据
01

先验证连接

使用你的 API Key 请求服务状态与诊断接口，错误会就近说明。

02

再运行并发任务

设置请求类型、路由、并发数和时长，单次运行一个可取消任务。

03

回看真实报告

查看尝试、完成、成功与失败请求，以及延迟分位和实测吞吐。

READY WHEN YOU ARE

用真实数据开始验证。

打开控制台
WORKSPACE

控制台

连接后可运行服务内诊断与并发测试。Key 仅保存在当前页面内存中。

01

连接 API

输入由服务端签发的 Key。刷新或离开页面后需重新输入。

尚未连接。Key 不会写入浏览器存储或地址栏。
SERVICE

服务状态

○等待连接

连接 API Key 后读取服务与数据库状态。

BENCHMARK

并发测试

单任务运行
连接服务后可开始测试。
HISTORY

任务与报告

连接后加载保存在服务端的任务记录。

范围说明　并发测试只测本服务 ping / echo 接口，接口吞吐不代表 Google 搜索吞吐。搜索端点当前待接入。

REFERENCE

API 文档

接口使用 HTTPS JSON。除健康检查外，所有 API 请求均需在 Authorization 请求头中携带 Bearer Key。

认证

将服务端签发的 Key 放入 HTTP Header。请在你自己的安全环境中保存密钥，不要将真实 Key 写入公开代码或日志。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

健康检查

GET /healthz　公开的服务存活检查，不需要 Key。

GET /api/v1/status　读取版本、公开 Base URL、PostgreSQL 连接状态与能力状态。

响应结构示例，值非当前服务实测结果：

{"version":"dev","base_url":"https://serp.skyvora.cc","database":{"connected":true},"capabilities":{"search":"not_ready","benchmark":"available"}}

GET /api/v1/materials　读取鉴权后的服务资料、部署角色、诊断快照与能力边界。

响应结构示例，值非当前资料实测结果：

{"project":"Skyvora SERP","base_url":"https://serp.skyvora.cc","environment":"…","server_roles":["environment","task","nginx_api"],"limits":["search_not_ready"]}

诊断接口

GET /api/v1/bench/ping　检查服务内 HTTP 诊断路由。

响应结构示例，不代表当前请求结果：

{"request_id":"…","time":"RFC3339Nano","target":"ping"}

POST /api/v1/bench/echo　回显 JSON 请求体，用于验证请求路径。

{"payload":"hello"} → {"request_id":"…","bytes":5,"payload":"hello"}

并发任务

POST /api/v1/benchmarks　创建任务。目标为 ping 或 echo；路由为 origin 或 public；并发数范围 1–100，持续时间 1–60 秒，target_qps 范围 0–10000（0 为不限速）。

创建任务响应结构示例：

{"id":"uuid","status":"queued","config":{"target":"ping","route":"public","concurrency":10,"duration_seconds":10,"target_qps":0}}

GET /api/v1/benchmarks　查询历史任务。

GET /api/v1/benchmarks/{id}　查看任务进度或报告。

POST /api/v1/benchmarks/{id}/cancel　取消运行中的任务。

详情响应结构示例，数值不是实测结果：

{"id":"uuid","status":"completed","config":{"target":"ping","route":"public","concurrency":10,"duration_seconds":10,"target_qps":0},"report":{"configured_concurrency":10,"actual_max_concurrency":8,"attempted":100,"completed":100,"succeeded":98,"failed":2,"cancelled":0,"issued_qps":10,"completed_qps":9.8,"successful_qps":9.8,"runtime_seconds":10,"status_codes":{"200":98,"500":2},"latency_ms":{"p50":42,"p95":110,"samples":98,"sample_policy":"first_50000_completed_requests"}}}
curl https://serp.skyvora.cc/api/v1/benchmarks \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"target":"ping","route":"public","concurrency":10,"duration_seconds":10,"target_qps":0}'
错误响应
{"error":{"code":"...","message":"..."},"request_id":"..."}
错误会显示服务返回的说明；Key 不会放进 URL。
SERVICE MATERIALS

服务资料

资料仅通过已认证的服务端接口获取。页面不会读取或复制本地 docs 文件。

⌁
连接后加载部署资料

请在控制台输入 API Key，再返回此页读取公开配置与诊断入口。

去连接
等待鉴权后读取资料。
服务诊断入口

先在控制台连接 API Key，再调用鉴权诊断接口。

设计结构参考：Dataify 官网（仅视觉结构参考）。