JSON encoding and decoding

JSON is a popular format in which services exchange information. Functions allow parsing and modifying these payloads to integrate different services with each other.

Some of the examples that you can do:

  • Decode Stripe webhook and encode it into a Slack or Discord notification
  • Change Mailgun delivery notification into a Discord message
  • Send an email when a change is pushed to a specific Bitbucket branch

Decode JSON

To decode or encode JSON in a Lua function, import ‘json’ package:

-- import "json" package when working with JSON
local json = require("json")

-- example payload:
-- {
--   "user": "Peter",
--   "age": 25,
--   "city": "Edinburgh"
-- }

local request_payload, err = json.decode(r.RequestBody)
if err then error(err) end

-- now, request_payload is a normal JSON object and we
-- can access individual values

-- request will now have a single value 'Peter' in the body

Encode to JSON

To encode a structure back into a JSON string:

-- import "json" package when working with JSON
local json = require("json")

-- constructing a new object that we will encode
-- into a JSON string
local new_payload = {
    action= "hello", 
    message= "world"}

-- encoding
local encoded_payload, err = json.encode(new_payload)
if err then error(err) end

-- webhook request body is now changed to:
-- {
--   "action": "hello",
--   "message: "world"
-- }