Step 3/4: Get Cellular Stats for a gateway via API
Use one of the gateway IDs from Step 2 to get a specific gateway's cellular stats
1. Copy the gateway ID from the missed check-in call. Don’t have any gateways with missed check-ins? Call the gateway list API endpoint to return gateway IDs.
https://api.multitech.com/api/v1/gateways
It should return something like this. Copy the gateway ID:
2. Make a new request to this endpoint:
https://api.multitech.com/api/v1/gateways/{id} e.g. https://api.multitech.com/api/v1/gateways/7462c752-3c08-4ace-b878-900c90191a5fIt should return more information about a specific gateway’s cellular connection, like so:
Pro Tip: Look for changes in these parameters for troubleshooting cellular connectivity.
netreg – network registration status such as REGISTERED
rsrp – signal power (same as what your phone uses to show your cellular signal)
rssi – signal strength
rsrq – signal quality
network – network provider e.g. Verizon, AT&T, Vodafone, etc.
roaming – e.g. “false” to know whether the gateway is attempting to hop providers in the event of poor connection on another provider
If you’re bouncing from one cellular antenna to another, you might be on the edge of a cell. You can find this out if your mnc and/or mcc changes:
- mnc – mobile network code – a 2-3 digit code that identifies a mobile operator within that country
- mcc – mobile country code
You can find them as part of the gateway details API call, like so:
Now that you’re a little familiar with a few API use cases, let’s deploy API changes for your application to switch from using DHQ API to the Device Manager API.
Contact Support
Mon – Fri from 8am to 5pm CST support@multitech.com