Edit request/response

Search…
In this page we will demonstrate basic operations that you can achieve in functions.
Accessing request data (incoming webhook/API request)
Lua functions use r object that provide access to request data (headers, query, method and body) and can then update any HTTP request details.
Available data to access:
Method name
Type
Description
r.RequestBody
String
Request body.
r.RequestMethod
String
Request method (PUT, POST, DELETE, etc.).
r.RequestPath
String
Request path.
r.RequestRawQuery
String
Request query, for example if the request was made with /api?category=electronics, then the query will be category=electronics.
r.RequestHeader
Table
A table [foo]bar of headers.
r.RequestQuery
Table
A table [foo]bar of query.
Read request body
An example of accessing request body and decoding it:
1
-- import json package
2
local json = require("json")
3
​
4
-- request body is in r.RequestBody, use it as any other string:
5
local body, err = json.decode(r.RequestBody)
6
if err then error(err) end
Copied!
Reading request headers
To access specific header, use:
1
local my_header = r.RequestHeader["Your-Header-Name"]
Copied!
Reading request URL query
To read request URL query (for example /v1/api?hub.mode=subscribe&hub.challenge=1903260781&hub.verify_token=my-token") you have two options:
1.r.RequestQuery["hub.challenge"] which will return 1903260781 for this example.
2.r.RequestRawQuery which will return full raw query hub.mode=subscribe&hub.challenge=1903260781&hub.verify_token=my-token"
Modify request data
Available methods to update request:
Method name
Parameter Type
Description
r:SetRequestBody(“string”)
String
Update request body
r:SetRequestMethod(“string”)
String
Update request method
r:SetRequestRawQuery(“foo=bar”)
String
Update request raw query
r:SetRequestPath(“/extra/path”)
String
Set additional extra path
r:DeleteRequestHeader("key")
String
Delete header
r:SetRequestHeader(“key”, “value”)
String, String
Set new header key/value pair
An example how to update request object:
1
-- set body
2
r:SetRequestBody("new body")
3
-- set method
4
r:SetRequestMethod("string")
5
-- set raw query
6
r:SetRequestRawQuery("foo=bar")
7
-- set extra path
8
r:SetRequestPath("/extra/path")
9
-- set header
10
r:SetRequestHeader("Content-Type", "application/json")
11
-- delete header
12
r:DeleteRequestHeader("Very-Secret")
Copied!
Modify response
Note: customized responses only applicable if function is attached to the Input and not bucket’s Output.
Available methods to set customized response:
Method name
Parameter Type
Description
r:SetResponseBody(“string”)
String
Set response body
r:SetResponseStatusCode(201)
Integer
Set response status code
r:SetResponseHeader(“key”, “value”)
String, String
Set response header key/value pair
Getting configuration values
Configuration values in Lua functions allow sharing the code without sharing sensitive information or just configuration values that might change between accounts, teams, etc.
To add a new configuration value:
1.Create a function
2.Go to function details
3.Click on a tab “CONFIG VARIABLES”
4.Specify config variable key and value.
Once you have specified these details, you can start using them in your functions:
1
-- configuration is accessible from a global "cfg" variable
2
local project_id = cfg:GetValue("PROJECT_ID")
3
-- do something with the value
Copied!
Filtering requests
To filter requests based on body, headers or some external conditions, you can use r:StopForwarding() method. This will set webhook status to rejected and this webhook will not be forwarded:
1
-- in this example we will check the payload to make the decision
2
local json = require("json")
3
​
4
-- incoming request body example:
5
-- {
6
--   "action": "important",
7
--   "user": "joe"
8
-- }
9
​
10
local requestBody, err = json.decode(r.RequestBody)
11
if err then error(err) end
12
​
13
-- simple comparison of the payload
14
if requestBody["action"] == "not_important" then 
15
    -- request is not important, don't forward it
16
    r:StopForwarding()
17
    return
18
end 
19
-- Otherwise, continue forwarding or add any additional logic here
Copied!
Managing functions
Working with JSON
Last modified 28d ago
Copy link
Contents
Accessing request data (incoming webhook/API request)
Read request body
Reading request headers
Reading request URL query
Modify request data
Modify response
Getting configuration values
Filtering requests