API 概览

您可以在我们的 Swagger API page 页面中测试本文档中的 API 端点。

开始使用 SkyInsights API 前，您需要一个有效的 API Key。
如果您已经拥有 SkyInsights 平台账号，可以直接在平台内查看和管理您的 API Key。
如果您还没有账号，请访问 SkyInsights 并使用您的邮箱注册。
API Key 签发后，请务必妥善保管，不要在公开渠道中泄露，也不要分享给未授权人员。

API 目录

KYA

KYT

kyt/risk

附录

BASE URL

https://api.skyinsights.certik.com/v4

认证

必需请求头

要完成请求认证，请在请求中携带以下两个请求头，并填写有效凭证：

请求头字段	说明	示例值
`X-API-Key`	客户 API 访问的唯一标识	`hubbuxihpvznyrdfpsosmkghgegvdavn`
`X-API-Secret`	与 API Key 配套的密钥，用于安全认证	`TTYAVYAZJYABBTLDHHPEBVDPRFRRCDMY`

认证失败的后果

缺失、无效或已过期的 X-API-Key 或 X-API-Secret 将返回 401 Unauthorized 错误（详见错误页面）。
被 CertiK 撤销的凭证（例如因违反服务条款）同样会触发 401 Unauthorized 错误。

统一响应格式

所有 API 端点都遵循相同的顶层响应结构，只有 data 字段会因不同端点而变化：

顶层字段	类型	说明
`code`	Number	状态码：200 成功、400 请求错误、401 未授权、404 未找到、429 请求过于频繁、500 服务器内部错误
`message`	String	可读的结果说明（例如 `"success"`、`"invalid chain"`）
`data`	Null/Object/Array	具体业务响应内容（仅在成功时返回，结构因端点而异）

成功响应模板

{
  "code": 200,
  "message": "success",
  "data": {
    // 端点特定内容
  }
}

错误响应模板

{
  "code": 400,
  "message": "invalid chain",
  "data": null
}