Transformations can be restricted to responses with specific status codes using various config.*.if_status configuration parameters.
Priortiy: 902 Default 800 on kong. to make it work before the plugin response-ratelimiting response-ratelimiting's priorty is 900
Response Transformer Extra includes the following additional configurations: add.if_status, append.if_status, remove.if_status, replace.if_status and rename.if_status.
Config | Type | Description |
---|---|---|
config.remove.if_status [ Optional ] | array of string elements | List of response status codes or status code ranges to which the transformation will apply. Empty means all response codes. |
config.rename.if_status [ Optional ] | array of string elements | List of response status codes or status code ranges to which the transformation will apply. Empty means all response codes. |
config.replace.if_status [ Optional ] | array of string elements | List of response status codes or status code ranges to which the transformation will apply. Empty means all response codes. |
config.add.if_status [ Optional ] | array of string elements | List of response status codes or status code ranges to which the transformation will apply. Empty means all response codes. |
config.append.if_status [ Optional ] | array of string elements | List of response status codes or status code ranges to which the transformation will apply. Empty means all response codes. |
NOTE: range feature is not implemented yet
$ pongo run
$ pongo shell
$ kong migrations bootstrap --force
$ kong start
$ curl -i -X POST \
--url http://localhost:8001/services/ \
--data 'name=example-service' \
--data 'url=http://konghq.com'
$ curl -i -X POST \
--url http://localhost:8001/services/example-service/routes \
--data 'hosts[]=example.com'
$ curl -X POST http://localhost:8001/services/example-service/plugins/ \
--header 'content-type: application/json' \
--data '{"name": "response-transformer-extra", "config": {"add": {"headers": ["h1:v2", "h2:v1"], "if_status": ["200", "301"]}}}'
$ curl -I -H "Host: example.com" http://localhost:8000/
$ pongo run
specific path, tests
$ pongo run -- ./spec/response-transformer-extra/01-header_transformer_spec.lua