跳转到正文
IsSafeSite

API 文档

通过 REST API 发起扫描、查看结果并获取报告。

身份验证

在请求中添加 Authorization: Bearer <API_KEY>。请妥善保管密钥,不要在客户端代码中公开。

扫描接口

POST /api/v1/scan 创建扫描;GET /api/v1/scan 获取扫描列表。请求和响应使用 JSON。

报告与错误

GET /api/v1/report 获取报告。调用前请查看套餐限额;遇到认证、参数或限流错误时,检查 HTTP 状态码和响应内容。

在控制台 → 设置 → API 密钥中创建密钥。

https://issafesite.com/api/v1

免费版:每天 3 次扫描、每分钟 10 次 API 请求;Pro:每天 50 次扫描、每分钟 60 次请求;Team:不限扫描次数、每分钟 300 次请求。

POST 请求体必须包含 url;depth 可选 QUICK、STANDARD(默认)或 DEEP。列表接口可使用 page(默认 1)和 limit(默认 20,最多 50);报告列表还可用 scanId 过滤。

curl -X POST https://issafesite.com/api/v1/scan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","depth":"STANDARD"}'

成功创建扫描返回 202,列表返回 200。错误响应为包含 error 字段的 JSON;401 表示缺少密钥,403 表示密钥无效或过期。

查看英文原版的完整细节