UNLOCK API
获取 API 密钥
API 密钥与安全
MarkdownOpenAPI

API 密钥与安全

如何发送密钥、使用多个密钥、只允许你的服务器访问。

你的密钥

每个请求都要带上账户页面上的 API 密钥：JSON 请求中为 clientKey，in.php 和 res.php 中为 key。密钥为 32 个字符（0-9、a-f）。请把它保存在服务器上；任何拿到密钥的人都能花掉你的余额。
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

更多密钥

你可以在账户页面上最多再创建 5 个密钥，例如每台服务器或每个项目一个。它们共用余额，显示最后使用时间，并且可以逐个停用。

IP 白名单

在账户页面上最多添加 20 个 IP 地址，之后只有这些地址能使用你的密钥。来自其他地址的请求会收到 ERROR_IP_NOT_ALLOWED，且不扣费。
错误
{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

从浏览器调用

发送 header_acao=1 时，in.php 和 res.php 会加上 CORS 头 Access-Control-Allow-Origin: *。从公开网页调用 API 会暴露你的密钥，因此只在你自己的工具中使用。