VerificationStatus enum

What HttpProtect.verify() concluded about a request.

Signature:

export declare enum VerificationStatus 

Enumeration Members

Member

Value

Description

BANNED

2

On the block list, having passed HttpProtectOptions.banLimit. Paired with HTTP 418. Does not recover — see HttpProtectOptions.banLimit.

LIMITED

1

Rate limited: the address is over HttpProtectOptions.maxRequests but under HttpProtectOptions.banLimit. Paired with HTTP 429. Recovers by itself once the address is quiet for HttpProtectOptions.ttl seconds.

SAFE

0

Serve the request. Either the address is within HttpProtectOptions.safeNetworks, or its count is still under HttpProtectOptions.maxRequests. Paired with HTTP 200.

Remarks

Only SAFE means "serve it". The two rejection values differ in how the client recovers, not in how you should respond: LIMITED lapses on its own, BANNED does not.

Read this page as plain markdown — no HTML, no navigation. For pasting into an LLM, or for an agent to fetch.