余额查询API
查询与 API 密钥关联的当前可用余额。
API 端点
GET https://api.checknumber.ai/v1/balance
请求头
| 请求头 | 说明 |
|---|---|
X-API-Key | string,必填 API 密钥;也接受 X-Access-Key |
成功响应示例
{ "balance": 9850.50}未授权响应示例
{ "error": "unauthorized", "message": "需要访问密钥(X-API-Key 或 X-Access-Key)"}响应字段
| 字段 | 说明 | 示例 |
|---|---|---|
balance | API 密钥对应的可用余额(积分) | 9850.50 |
状态码
| 状态码 | 说明 |
|---|---|
200 | 请求成功 |
401 | 未授权:API 密钥缺失或无效 |
502 | 余额查询失败:上游服务错误 |