账户

账户 API

您的套餐、额度及剩余用量。

获取限制

GET/v1/user/limits

API 密钥

响应字段

accountTypestring
套餐名称，如 Free 或 Pro。
limitinteger
本月允许的请求数。
usageinteger
本月已用请求数。
remaininginteger
本月剩余请求数。
resetDatestring
月度额度的重置日期。
daily.limitinteger
今日允许的请求数，适用于有每日上限的套餐。
daily.usedinteger
今日已用请求数。
daily.remaininginteger
今日剩余请求数。
daily.resetAtstring
每日窗口的重置时间。
hourly.limitinteger
本小时允许的请求数。
hourly.usedinteger
本小时已用请求数。
hourly.remaininginteger
本小时剩余请求数。
hourly.resetAtstring
每小时窗口的重置时间。

curl https://ipscanner.io/v1/user/limits \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

{
  "accountType": "Free",
  "limit": 30000,
  "usage": 4180,
  "remaining": 25820,
  "resetDate": "2026-11-01",
  "daily": {
    "limit": 1000,
    "used": 212,
    "remaining": 788,
    "resetAt": "2026-10-07T00:00:00Z"
  },
  "hourly": {
    "limit": 100,
    "used": 14,
    "remaining": 86,
    "resetAt": "2026-10-06T15:00:00Z"
  }
}

获取用量

GET/v1/usage/summary

API 密钥

响应字段

planstring
套餐名称。
usedinteger
本月已用请求数。
limitinteger
本月允许的请求数。
remaininginteger
本月剩余请求数。
percentnumber
月度额度的已用比例。
unlimitedboolean
无月度上限的套餐为 true。
softBlockedboolean
账户超出限制时为 true。
blockedBystring
当前拦截您的限制：monthly、daily、hourly 或为空。
bulkCapinteger
您的套餐下单次批量调用的地址上限。
periodStartstring
计费月的第一天。
resetDatestring
月度额度的重置日期。

curl https://ipscanner.io/v1/usage/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

{
  "plan": "Free",
  "used": 4180,
  "limit": 30000,
  "unlimited": false,
  "remaining": 25820,
  "percent": 13.9,
  "softBlocked": false,
  "blockedBy": "",
  "upgradeHint": false,
  "bulkCap": 100,
  "daily": {
    "limit": 1000,
    "used": 212,
    "remaining": 788,
    "resetAt": "2026-10-07T00:00:00Z"
  },
  "hourly": {
    "limit": 100,
    "used": 14,
    "remaining": 86,
    "resetAt": "2026-10-06T15:00:00Z"
  },
  "periodStart": "2026-10-01",
  "resetDate": "2026-11-01",
  "asOf": "2026-10-06T14:05:00Z"
}