Kuidas nutiarvestid Ridgelyga ühendada

Nutiarvesti saadab näidu raadio teel (LoRaWAN või M-Bus) sinu paigaldaja võrguserverisse. Server saadab selle edasi Ridgely veebihaagile (webhook) ja näit ilmub kohe õige korteri arvesti alla. Kui ühistul on ka käsitsi arvesteid, töötavad mõlemad kõrvuti.

1. 1Telli paigaldusKüsi pakkumine oma piirkonna arvestipaigaldajalt (LoRaWAN vee- ja elektriarvestid või M-Bus koondaja keldris). Ridgely ei müü riistvara, valik jääb ühistule.
2. 2Võta Ridgelyst webhooki aadress ja salajane võtiRakenduses Näidud lehel ava plokk Automaatne sisselugemine, vajuta Genereeri ja kopeeri mõlemad väljad. Võti on nähtav ainult üks kord.
3. 3Anna need paigaldajalePaigaldaja lisab need oma platvormil (The Things Stack, ChirpStack, Wirepas, Kamstrup jne) väljundiks. Aadress läheb lahtrisse Webhook URL, võti päisesse x-ingest-secret.
4. 4Seo arvesti seerianumber korterigaLisa Ridgelys iga arvesti sama seerianumbriga, mis on paigaldaja nimekirjas. Kui number klapib, jõuab näit õigesse korterisse. Esimene näit saabub tavaliselt tunni jooksul.

Ridgely võtab vastu kaks kuju. Lihtne loend sobib igale platvormile, The Things Stacki uplink läheb läbi ilma muutmata.

{
  "readings": [
    { "serial": "WM-100234", "value": 128.412, "unit": "m3" },
    { "serial": "EM-556001", "value": 4821.7, "unit": "kWh",
      "timestamp": "2026-01-31T23:50:00Z" }
  ]
}

Väljad

• serial, arvesti seerianumber täpselt nii, nagu see on Ridgelys
• value, näidu number (m³ vee puhul, kWh elektri puhul)
• unit, valikuline ühik
• timestamp, valikuline ISO 8601 aeg, muidu kasutatakse saabumise aega

curl -X POST \
  https://ridgely.homes/api/public/meter-ingest/<building-id> \
  -H "content-type: application/json" \
  -H "x-ingest-secret: <secret>" \
  -d '{"readings":[{"serial":"WM-100234","value":128.412,"unit":"m3"}]}'

Need on täpsed väljad, mida paigaldaja peab oma platvormil täitma. Kopeeri need talle koos webhooki aadressi ja võtmega.

• The Things Stack: Integrations, Webhooks, Add webhook. Format JSON, Base URL sinu webhooki aadress, lisa päis x-ingest-secret, märgi ainult Uplink message. Muud teisendust pole vaja, Ridgely loeb decoded_payload väljalt value või reading ning seerianumbri väljalt serial või device_id.
• ChirpStack: Applications, sinu rakendus, Integrations, HTTP. Payload encoding JSON, Event endpoint URL sinu webhooki aadress, Headers lisa x-ingest-secret. ChirpStack saadab sama uplinki kuju.
• M-Bus koondaja (Elvaco CMe, Kamstrup, Milesight gateway): vali HTTP push või Custom HTTP report, meetod POST, content-type application/json, päis x-ingest-secret, kehaks lihtne readings loend. Kui koondaja saadab oma kuju, palu paigaldajal seadistada mall ülaltoodud näidise järgi.
• Muu platvorm või oma skript: piisab POST päringust, mis saadab readings loendi. Ühtegi SDK-d ega kontot pole vaja.

• 401 unauthorized: võti on vale või kopeerimisel jäi tühik. Genereeri uus ja anna paigaldajale.
• 200, aga näitu pole: seerianumber ei klapi. Võrdle Ridgely arvesti numbrit paigaldaja omaga.
• Kõik katsed on näha Näidud lehel plokis Viimased sisselugemised koos veateatega.

Nutiarvesti lisandmoodul Ridgelys on €0.55 elektriarvesti ja €0.75 veearvesti kohta kuus, igas paketis. Arvestite ja paigalduse eest tasub ühistu otse paigaldajale.