Skip to main content

Troubleshooting

“Unauthorized: missing API key” (HTTP 401)​

This typically means you called a workspace endpoint without a key.

  • For a quick test, call the guest persona: POST https://dralvia.tech/api/guest/scan
  • For workspace usage, generate a key at https://dralvia.tech/#/api-keys and send it as:
    • Authorization: Api-Key <key> (preferred) or
    • X-API-KEY: <key> (legacy)

“quota_exceeded” (HTTP 402)​

Your API key’s monthly quota has been reached.

  • Reduce scan volume (cache results where possible).
  • Wait for the next monthly quota period to reset.
  • If you need higher volume, switch plans (see #/pricing) or use PAYG metering.

“Too many requests” (HTTP 429)​

You are sending requests too quickly.

  • Retry with exponential backoff.
  • For batch workloads, use POST /scan/bulk and poll GET /scan/jobs/<id>.

“Invalid domain name” (HTTP 400)​

The scan endpoint expects a domain field in the JSON body:

{ "domain": "example.com" }

If you have a full URL, you can still send it under domain (Dralvia will normalize it).

The portal says “You’re in guest mode”​

  • Click Sign in / Sign up to authenticate.
  • If you signed in but still see guest mode, refresh the page and confirm third-party cookies/popups are not blocked for the login flow.