帳戶

帳戶 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"
}