Adrese un piekļuves tvērums
Sūtiet POST pieprasījumus uz /api/v2/meters/readings/import ar readings masīvu. Izsaucējam jābūt iznomātāja kontā un nepieciešama meter_reading:write atļauja.
Šī adrese saglabā rādījumus esošiem skaitītājiem. Tā neveido skaitītājus vai konta integrācijas ierakstus. Katram mērķa skaitītājam iestatiet automātisku rādījumu iesūtīšanu Proforio.
Autentifikācija
Izmantojiet vai nu autorizēta lietotāja JWT nesēja tokenu, vai aktīvā konta lietotnes piekļuves datu pāri.
- JWT: sūtiet Authorization: Bearer <token>.
- Lietotnes piekļuves dati: katrā pieprasījumā sūtiet gan X-App-Key, gan X-App-Secret. Ar vienu no šīm galvenēm autentifikācijai nepietiek.
Dati un skaitītāja atrašana
Katram readings ierakstam nepieciešama value un read_at vērtība, kā arī vismaz viens skaitītāja identifikators. previous_value un raw_payload nav obligāti.
- meter_id atrod skaitītāju autentificētajā kontā pēc tā ID.
- external_meter_id atrod unikālu ārējo ID autentificētajā kontā.
- meter_serial_number atrod unikālu sērijas numuru. Norādiet property_id, ja viens sērijas numurs var būt vairākos īpašumos.
- Ja norādīti vairāki identifikatori, vispirms pārbauda meter_id, pēc tam external_meter_id un tad meter_serial_number.
Notikumu piemērošana
Proforio saglabā katru pieņemto vērtību kā neapstrādātu rādījuma notikumu. Ja notikuma laikam ir piemērots atvērts oficiālais rādījums, notikumu var tam piemērot; citādi tas paliek saglabāts parastajam rādījumu dzīves ciklam.
Pārbaudiet atbildes skaitītājus un katras rindas rezultātu. Veiksmīga HTTP atbilde var ietvert rindas, kas saglabātas vai noraidītas, nevis piemērotas.
Atkārtojiet piesardzīgi
Šī vispārīgā adrese neatpazīst atkārtotus pieprasījumus. Atkārtoti nosūtot tos pašus datus, var tikt izveidots vēl viens neapstrādāts notikums. wmbusmeters izmanto savu autentificēto savienotāju un dublikātu novēršanu, bet CSV un XML augšupielāde paliek manuāla rādījumu darbplūsma.