點數餘額

請求參數

這個介面沒有參數。

請求範例

curl "https://seo-api.org/api/v1/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

回應範例

回傳 { creditsRemaining }。命令列工具的 login 用它驗證 key。

{ "ok": true, "data": { "creditsRemaining": 99 } }

錯誤碼

• SEO_API.MISSING_API_KEY

  HTTP401

  含義沒有 Authorization 標頭，也沒有 x-api-key 標頭。

• SEO_API.INVALID_API_KEY

  HTTP401

  含義key 不存在或已被撤銷。

• SEO_API.INVALID_DOMAIN

  HTTP400

  含義缺少 domain 參數，或者它不是網域（IP 會被拒絕）。

• BILLING.INSUFFICIENT_CREDITS

  HTTP402

  含義帳號點數用完了。24 小時內的重複查詢仍然可用。

• SYSTEM.INTERNAL_SERVER_ERROR

  HTTP500

  含義我們這邊出了問題，請稍候再重試。

透過 MCP 呼叫

工具名稱 get_credit_balance，參數與回傳內容和 REST 呼叫一致。

{
  "name": "get_credit_balance",
  "arguments": {}
}

透過命令列呼叫

npx @seo-api/cli credits