Many of our integration submodules rely on these push events for full functionality. Interested in developing your own plugins? Expand the push event and API endpoint documentation in the left side drawer.
Web Server Example
Javascript
You can create your own web server to listen and receive Sonoran CAD events. This could be on a Discord bot, an in-game script, etc.
In addition, you may already be receiving these events in your FiveM resource. The resource can be configured to "forward" all push events received to another custom webserver, like the example shown below. Simply set enablePushEventForwarding to true and pushEventForwardUrl to your webserver's http://IP:Port.
Example JS Webserver
// ----------------------------
// Webserver Handling
// Description: Create web server and listen to CAD push events locally
// ----------------------------
// Use the JS HTTP library to create a new webserver
// Pass any traffic to the 'handler' function
let server = require('http').createServer(handler);
// Sonoran CAD community API key
// Used to authenticate traffic received
const API_KEY = "YOUR_API_KEY";
// Start the webserver on a specific port
// Ensure you have this port OPEN on your external IP
// https://portchecker.co/
let port = 30150;
server.listen(port);
// Webserver traffic handler
async function handler (req, res) {
let data = ''; // Parsed JSON data
let success = false; // Successful parsing/handling
let responseMessage = ""; // Response text back to server
// Only handle POST requests
// Only handle requests sent to /sonorancad/event (CAD push events)
if (req.method === "POST" && req.url === '/sonorancad/event') {
req.on('data', function(chunk) {
// Read and piece each part of data together
data += chunk;
});
// Once we've fully read the request
req.on('end', async function() {
// Parse data string to a local JSON object
data = JSON.parse(data);
// Authenticate data
// Sonoran CAD sends your API KEY with the POST data
// Check this here to prevent someone random sending you requests
if (data.key === API_KEY) {
// Switch Case: handle each event type
switch (data.type) {
case "EVENT_911":
// New 911 call placed
// Format: https://info.sonorancad.com/sonoran-cad/api-integration/push-events/event-911
console.log(`New 911 from ${data.caller}`);
break;
default:
// Push event type isn't handled here
responseMessage = "Invalid Type";
success = false;
sendResponse(success);
break;
}
} else {
// Server traffic didn't have the proper API key
responseMessage = "Authentication Key Failed!";
success = false;
sendResponse(success);
}
});
}
// Send response back to server
function sendResponse(success) {
// Return an HTTP 200 or 400 based on `success` boolean
const statusCode = success ? 200 : 400;
// Set response headers
res.writeHead(statusCode, {'Content-Type': 'text/plain'});
// Return response
res.end(responseMessage);
}
}