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.

Gebeurtenissen die als webhook binnenkomen
GebeurtenisWanneer
device.offlineEen gateway is offline
device.onlineEen gateway is weer online
alert.triggeredEen alarm gaat af
alert.returnedDe waarde is weer normaal
alert.acknowledgedIemand bevestigt het alarm
alert.resolvedHet alarm is opgelost
automation.triggeredEen 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 sandbox

Specificaties van de API

Specificaties van de ModbusCloud API
Verzoeken
Adresapi.modbuscloud.com/v1
FormaatREST over HTTPS, antwoorden in JSON
SpecificatieOpenAPI 3.1, te importeren in Postman of om een client mee te genereren
SleutelsPer organisatie, met scopes. Je ziet een sleutel één keer, en je laat hem verlopen of trekt hem in wanneer je wilt
Limiet100 verzoeken per minuut per sleutel, met de resterende ruimte in elk antwoord
FoutmeldingenProblem Details (RFC 9457) met een vaste foutcode en een request-id
SchrijvenRegisters schrijven via de API zetten we op aanvraag aan
Data
GegevensGateways met hun Modbus-apparaten, registers, historie en alarmen
WaardenOmgerekend naar de eenheid uit het portaal, met de ruwe waarde erbij
HistorieTot 12 maanden. Elke uitgelezen waarde, standaard één per vijf minuten en hooguit één per minuut
OphalenPer pagina met een cursor, tot 1000 metingen per keer
Webhooks
GebeurtenissenGateway offline en weer online, alarm afgegaan, hersteld, bevestigd en opgelost, automatisering uitgevoerd
HandtekeningStandard Webhooks (HMAC-SHA256)
Opnieuw proberenTot zes keer binnen ruim zeven uur, met hetzelfde id
Algemeen
HostingAPI en database in Ierland (EU)
PrijsInbegrepen bij elke licentie, zonder kosten per verzoek
SandboxDemo-account, zonder eigen account, 60 verzoeken per minuut

Zelf zien hoe het werkt?

Monteur met een laptop bij een installatie