Module request_validation 

The request-validation node — validates request headers and/or body against JSON Schemas before the request reaches the upstream, rejecting non-conforming requests with a configurable status code.

Port of APISIX’s request-validation plugin. Schemas are compiled once at config load (invalid schemas fail policy compilation, not requests). Bodies are validated as JSON by default; application/x-www-form-urlencoded bodies are decoded into a flat object first, mirroring the Lua plugin’s ngx.decode_args shape (duplicate keys become arrays, keys without = become true).

Structs

RequestValidationPlugin

Validates context.request headers and body against compiled JSON Schemas, and optionally evaluates boolean condition predicates on the request. On failure the request is rejected through the denied port with a JSON response using rejected_code.

Functions

compile_schema 🔒

Compiles an optional schema key into a validator, failing fast with the key name on malformed schemas.

decode_urlencoded 🔒

Decodes an application/x-www-form-urlencoded body into a flat JSON object, mirroring ngx.decode_args: a=1&a=2 becomes {"a": ["1","2"]}, a bare flag (no =) becomes {"flag": true}, values are percent-decoded and + maps to space.

hex_val 🔒

urldecode 🔒

Percent-decodes a urlencoded component (+ becomes space; malformed escapes pass through literally).