快速开始
欢迎使用 APIhh 文档。我们的平台提供了一个统一的接口来访问高性能 API。
认证方式 (Authentication)
所有 API 请求必须使用 Authorization 头部进行认证,并携带 Bearer token。
Authorization: Bearer YOUR_API_KEY
您可以从 控制台 获取您的 API Key。
接口限制 (Rate Limits)
为了保证服务的稳定性,我们对 API 调用进行了速率限制。 普通用户默认限制为:
- 100 次/分钟
- 10,000 次/天
如果是企业用户,请联系我们获取更高的配额。
错误返回 (Error Handling)
当请求失败时,API 会返回统一的 JSON 格式错误信息:
{
"code": 401,
"error": "Unauthorized",
"message": "Invalid API Key"
}
常见错误码
| 错误码 | 描述 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 未授权(无效的 API Key) |
| 403 | 禁止访问(配额耗尽或权限不足) |
| 429 | 请求过多(触发限流) |
| 500 | 服务器内部错误 |