API文档导航

认证

了解如何认证您的API请求以便访问我们的服务。

安全提示

请妥善保管您的API密钥，不要在客户端代码中暴露它们。建议通过服务器端进行API调用。

Bearer令牌认证

所有API请求需要通过Authorization请求头进行身份验证，使用Bearer令牌方案。您的API密钥应作为Bearer令牌值传递。

示例

Authorization: Bearer YOUR_API_KEY

认证示例

curl -X POST https://api.captcha-api.com/v1/solve/recaptcha \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "sitekey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "url": "https://example.com"
  }'

认证错误

当认证失败时，服务器将返回401 Unauthorized状态码和相应的错误消息。

常见认证错误

缺少API密钥

{
  "success": false,
  "code": 1001,
  "message": "Authorization header is missing"
  }

无效的API密钥

{
  "success": false,
  "code": 1002,
  "message": "Invalid API key"
}

API密钥已禁用

{
  "success": false,
  "code": 1003,
  "message": "API key has been disabled"
}

余额不足

{
  "success": false,
  "code": 1004,
  "message": "Insufficient balance"
}