← 返回首页

🔍 SEO智检 API 文档

v2.0 · RESTful API · JSON响应

目录 🔐 认证 📊 单站审计 🔀 对比审计 📦 批量审计 📋 历史记录 🔗 分享 ⚙️ 管理接口
⚠️ 频率限制: 每个IP每天最多5次审计请求。对比审计消耗2次配额,批量审计消耗N次配额。

🔐 认证

所有审计接口需要在请求头中携带 X-Auth-Token。通过注册接口获取Token。

POST /api/register

注册新用户或登录已有用户

参数类型说明
namestring 必填姓名
phonestring 必填手机号
emailstring 必填邮箱
companystring 选填公司名称
// 响应
{ "token": "abc123...", "user": { "name": "张三", ... }, "message": "注册成功!" }
GET /api/me 需认证

获取当前用户信息

📊 单站审计

POST /api/audit 需认证

发起SEO审计

参数类型说明
urlstring 必填要审计的网站URL
coveragestring 选填扫描范围: quick(25页) / surface(100页,默认) / full(500页)
// 响应
{ "jobId": "a1b2c3d4", "status": "started", "url": "https://example.com/" }
GET /api/audit/:jobId

获取审计结果

GET /api/audit/:jobId/stream

SSE实时进度流

// 事件类型
{ "type": "progress", "message": "Crawling page 5/100..." }
{ "type": "done", "job": { "id": "...", "score": 85, ... } }
{ "type": "error", "error": "..." }

🔀 对比审计

POST /api/audit/compare 需认证

对比两个URL的SEO评分(消耗2次配额)

参数类型说明
url1string 必填第一个URL
url2string 必填第二个URL
coveragestring 选填扫描范围

📦 批量审计

POST /api/audit/batch 需认证

批量审计多个URL(最多10个,消耗N次配额)

参数类型说明
urlsstring[] 必填URL数组,最多10个
coveragestring 选填扫描范围
// 请求
{ "urls": ["https://a.com", "https://b.com", "https://c.com"], "coverage": "quick" }

// 响应
{ "batchId": "batch-a1b2c3d4", "status": "started", "total": 3 }
GET /api/audit/batch/:batchId/stream

批量审计SSE进度流

📋 历史记录

GET /api/my/audits 需认证

获取当前用户的审计历史(最近50条)

GET /api/url-history?url=https://example.com 需认证

获取特定URL的历史评分(用于趋势图表)

🔗 分享

GET /api/share/:jobId

获取可公开分享的审计结果(无需认证)

⚙️ 管理接口

所有管理接口需要 ?key=管理密钥 参数

GET /api/admin/stats?key=xxx

获取统计仪表盘数据(用户数、审计数、分数分布、每日趋势、热门域名)

GET /api/admin/users?key=xxx

用户列表

GET /api/admin/audits?key=xxx

审计日志(最近100条)

GET /api/health

健康检查(无需认证)

{ "status": "ok", "uptime": 12345.67, "jobs": 0, "users": 3, "audits": 5 }

Frequently Asked Questions

Is this product worth buying?

Based on customer reviews and expert analysis, this product offers excellent value for money with high-quality features and reliable performance.

How long does shipping take?

Most orders ship within 24-48 hours and arrive within 3-7 business days depending on your location.

What is the return policy?

We offer a 30-day money-back guarantee. If you are not satisfied, you can return the product for a full refund.