REST API en webhooks voor jouw Modbus-data
Haal elke waarde die jouw gateways lezen op in je eigen software. De API zit in elke licentie.
VerzoekGET
curl https://api.modbuscloud.com/v1/devices/3f9c2a71/registers \
-H "Authorization: Bearer mlk_…"Antwoord200 OK
{
"data": [
{
"modbus_device_name": "Eastron SDM630",
"name": "Spanning L1",
"unit": "V",
"latest_value": 231.4,
"latest_ts": "2026-10-05T14:02:00.000Z"
},
{
"modbus_device_name": "Eastron SDM630",
"name": "Vermogen totaal",
"unit": "W",
"latest_value": 4180.6,
"latest_ts": "2026-10-05T14:02:00.000Z"
}
]
}- Prijs
- In elke licentie
- Historie
- 12 maanden
- Limiet
- 100 verzoeken per minuut
- Specificatie
- OpenAPI 3.1
- Hosting
- Ierland (EU)
Wat je via de API ophaalt
Gateways en apparaten
Elke gateway met zijn status, het 4G-signaal en de IP-adressen, en de Modbus-apparaten erachter.
Registers met de laatste waarde
Al omgerekend naar de eenheid die je in het portaal ziet. De ruwe waarde komt mee.
Historie
Tot twaalf maanden terug. Je haalt hem per pagina op, zodat je een volledige kopie in je eigen database bijhoudt.
Alarmen
Elk alarm met zijn status, van afgegaan tot opgelost.
Elk systeem dat een HTTPS-verzoek kan doen, werkt ermee. Zo komen de waarden in een BI-dashboard, een ERP-systeem, een datawarehouse, een gebouwbeheersysteem of jouw eigen software.
Webhooks als een gateway uitvalt of een alarm afgaat
Jouw systeem hoort het als een gateway offline gaat of weer online komt, en als een alarm afgaat, herstelt, bevestigd of opgelost wordt.
Elke webhook is ondertekend volgens de open specificatie Standard Webhooks. Voor elke gangbare programmeertaal is er een library die de handtekening controleert.
Is jouw ontvanger even onbereikbaar, dan proberen we het opnieuw, tot zes keer binnen ruim zeven uur. Een herhaling heeft hetzelfde id, dus je verwerkt niets dubbel. Vanuit het portaal stuur je een testbericht.
| Gebeurtenis | Wanneer |
|---|---|
| device.offline | Een gateway is offline |
| device.online | Een gateway is weer online |
| alert.triggered | Een alarm gaat af |
| alert.returned | De waarde is weer normaal |
| alert.acknowledged | Iemand bevestigt het alarm |
| alert.resolved | Het alarm is opgelost |
| automation.triggered | Een automatisering voert een actie uit |
Proberen zonder account
In de documentatie staat een sandboxsleutel voor ons demo-account, het portaal van een fictief installatiebedrijf.
Elke aanroep in de documentatie voer je daarmee meteen uit, zonder account. De sandbox leest alleen.
Proberen met de sandboxSpecificaties van de API
| Verzoeken | |
|---|---|
| Adres | api.modbuscloud.com/v1 |
| Formaat | REST over HTTPS, antwoorden in JSON |
| Specificatie | OpenAPI 3.1, te importeren in Postman of om een client mee te genereren |
| Sleutels | Per organisatie, met scopes. Je ziet een sleutel één keer, en je laat hem verlopen of trekt hem in wanneer je wilt |
| Limiet | 100 verzoeken per minuut per sleutel, met de resterende ruimte in elk antwoord |
| Foutmeldingen | Problem Details (RFC 9457) met een vaste foutcode en een request-id |
| Schrijven | Registers schrijven via de API zetten we op aanvraag aan |
| Data | |
| Gegevens | Gateways met hun Modbus-apparaten, registers, historie en alarmen |
| Waarden | Omgerekend naar de eenheid uit het portaal, met de ruwe waarde erbij |
| Historie | Tot 12 maanden. Elke uitgelezen waarde, standaard één per vijf minuten en hooguit één per minuut |
| Ophalen | Per pagina met een cursor, tot 1000 metingen per keer |
| Webhooks | |
| Gebeurtenissen | Gateway offline en weer online, alarm afgegaan, hersteld, bevestigd en opgelost, automatisering uitgevoerd |
| Handtekening | Standard Webhooks (HMAC-SHA256) |
| Opnieuw proberen | Tot zes keer binnen ruim zeven uur, met hetzelfde id |
| Algemeen | |
| Hosting | API en database in Ierland (EU) |
| Prijs | Inbegrepen bij elke licentie, zonder kosten per verzoek |
| Sandbox | Demo-account, zonder eigen account, 60 verzoeken per minuut |
Zelf zien hoe het werkt?








