API 概览

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

开始使用 SkyInsights API 前，您需要一个有效的 API Key。
如果您已经拥有 SkyInsights 平台账号，可以直接在平台内查看和管理您的 API Key。
如果您还没有账号，请联系 bd@certik.com 来获取权限。
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
}