keepa_get_quota

查询当前 API Key 对应账号的套餐与剩余调用次数。不消耗 units，不写入使用日志。

用途

• 调用大批量工具前先看一下额度
• 做客户端自适应限速时的探针
• 与 HTTP API GET /api/quota（别名 GET /api/token）完全等价

参数

本工具无参数。

{}

计费

• 免费（0 units）
• 不受每分钟限速约束

返回结构

{
	"success": true,
	"data": {
		"serverTime": "2026-05-11T03:21:45.000Z",
		"offPeakWindow": {
			"start": "19:00",
			"end": "07:00",
			"timezone": "Asia/Shanghai"
		},
		"offPeakActive": false,
		"activeBilling": "general",
		"nextCallRejectReason": null,
		"nextCallRejectMessage": null,
		"keyWarning": null,
		"general": {
			"subscribed": true,
			"plan": { "id": 12, "name": "通用标准" },
			"subscriptionEnd": "2026-06-01T00:00:00.000Z",
			"quantity": 1,
			"minute": { "limit": 60, "used": 3, "remaining": 57 },
			"daily": { "limit": 10000, "used": 234, "remaining": 9766 },
			"monthly": { "limit": 300000, "used": 12345, "remaining": 287655 },
			"resetAt": {
				"minute": "2026-05-11T03:22:00.000Z",
				"daily": "2026-05-12T00:00:00.000Z",
				"monthly": "2026-06-01T00:00:00.000Z"
			}
		},
		"off_peak": { "subscribed": false }
	},
	"metadata": { "responseTime": "12ms" }
}

字段定义与 HTTP 完全一致，详见 GET /api/quota 字段说明。要点：

• 未订阅的钱包是 { "subscribed": false }；订阅后才出现 plan / minute / daily / monthly / resetAt
• activeBilling 表示下一次调用会扣减哪个钱包；null 时下一次调用必被拒（nextCallRejectReason 给出原因码）
• off_peak 钱包额外携带 window，标明闲时窗口（默认 19:00–07:00 Asia/Shanghai）

和 metadata.quotaHint 的区别

• quotaHint（每次成功响应带的）：调用后的余量快照，最准确
• keepa_get_quota：不经过扣费链路的独立查询，适合开机自检或后台监控

和 HTTP API 的对应

• HTTP：GET /api/token — 完全等价