
Webhooks & Firehoses
FD1 Server Messages
A Server message is where the FD1 server sends a message to the client that might be unexpected or out of bound. For example a server might send a message advising it is going to close the websocket shortly.
Most activity is driven from the client, your end, and the server responds. This can be a single request-response, or multiple responses request-response/response/response.
A server generated message uses a request packet, and the "a" field starts with "fn1."
{ a: "fn1.link.link_status", v: { message: "Server is powering down in 15 minutes", ... } }
Websocket/Link Advisory Messages
These messages are sent to advise the status of the overall network connecton.
Fields present in "v"
Name | Descripton | Example |
message | A message broadcast that should ideally be displayed to the end user. | "Store is closing in 15 minutes" |
servers | An array of alternative server URLs that can be used instead of the current server. | [ { url: "wss://anotherserver.local/usefd1" } ] |