
Webhooks & Firehoses
FD1 Read Concepts
A read request is implmented by sending a JSON packet. As FD1 is primarily designed for websockets, the HTTP verbs are not used as there is no HTTP verb inside websockets. If you are using HTTP mode, you can read using GET or POST verbs - POST is used when large request data is required, or you are sending sensitive data and wish to reduce the chance of it being logged somewhere. (OWASP ref)
Reading non-existent data
If you request specific data that does not exist, the endpoint will respond with an empty result set.
Example, requesting with an unknown email
{ a: "fd1.customers.get_customers", q: { email: "spongebob@bikini.bottom" } }
Response
{ r: "fd1.customers.get_customers", data: { rows:[] } }