详细的API接口说明和使用指南
查询账号服务状态、当前 credits 余额、套餐、月额度使用量和实时限流计数。使用 X-API-Key 或 Bearer token 鉴权。
以下展示关键字段节选；实时响应可能包含更多原始 Twitter/X 字段。
{
"code": 200,
"msg": "success",
"data": {
"service": "ok",
"account_status": "active",
"credits": 2400.5,
"plan": "Ultra",
"plan_key": "ultra",
"active_until": "2026-08-01T00:00:00+00:00",
"rate_limit_per_second": 100,
"rate_limit_per_hour": null,
"rps_current": 2,
"rph_current": 12,
"monthly_limit": 50000,
"month_calls": 1234,
"monthly_remaining": 48766,
"quota_period_start": "2026-07-01T00:00:00+00:00"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 业务状态码。200 表示请求成功。 |
| msg | string | 响应消息。 |
| data | object | 接口返回的数据对象。 |
| service | string | data 对象里的服务可用状态。ok 表示 API 服务正常。 |
| account_status | string | data 对象里的账号状态，例如 active。 |
| credits | number | data 对象里的当前 credits 余额。 |
| plan | string | data 对象里的当前套餐展示名称。 |
| plan_key | string | null | data 对象里的当前套餐标识，例如 ultra；没有套餐时可能为 null。 |
| active_until | string | null | data 对象里的套餐有效期，ISO 8601 时间；没有有效期时为 null。 |
| rate_limit_per_second | number | null | data 对象里的每秒请求上限；未配置时为 null。 |
| rate_limit_per_hour | number | null | data 对象里的每小时请求上限；未配置时为 null。 |
| rps_current | number | data 对象里的当前秒级窗口请求次数。 |
| rph_current | number | data 对象里的当前小时窗口请求次数。 |
| monthly_limit | number | data 对象里的当前套餐月请求额度。 |
| month_calls | number | data 对象里的当前额度周期已使用请求次数。 |
| monthly_remaining | number | null | data 对象里的当前额度周期剩余请求次数；无固定月额度时为 null。 |
| quota_period_start | string | data 对象里的当前额度周期开始时间，ISO 8601 格式。 |
后端常见业务错误码说明。所有接口统一返回格式：{ code, msg, data }。
说明：`code` 是响应体中的业务状态码，可能与 HTTP 状态码不同。
| 错误码 | 名称 | 含义 | 建议处理 |
|---|---|---|---|
| 200 | 成功 | 请求处理成功。 | 读取 `data` 获取业务数据。 |
| 400 | 请求参数错误 | 参数不合法或业务校验未通过。 | 检查必填参数、取值范围与请求格式。 |
| 401 | 未授权 | 鉴权失败（未登录、缺少或无效 API Key）。 | 重新登录或传入有效的 `X-API-Key`。 |
| 402 | 余额不足 | 余额不足或调用次数已用完，无法完成本次调用。 | 请充值或升级套餐后重试。 |
| 403 | 无权限 | 没有访问权限或账户状态受限。 | 检查账户状态和接口访问权限。 |
| 404 | 资源不存在 | 请求的资源不存在。 | 检查 ID/订单号是否正确、数据是否存在。 |
| 429 | 请求过于频繁 | 触发每秒/每小时/月度限流。 | 降低请求频率，并使用退避重试。 |
| 500 | 服务器内部错误 | 服务端处理异常。 | 稍后重试；持续失败请联系支持。 |
| 502 | 服务暂时不可用 | 服务请求处理失败。 | 请稍后重试。 |
| 503 | 服务繁忙 | 系统繁忙或触发全局保护限制。 | 等待短时间后重试。 |
curl -X GET "https://www.twtapi.com/api-proxy/myapi/status?lang=zh" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-Lang: zh"
如果你还没有 API Key，先去 创建账号 或 打开 API Dashboard 查看当前套餐、额度和 key 管理入口。