Ordered a 12 Zone unit and a flow meter.
I read through the API doc and the main questions I have so far:
a) Do you have an expected min/max rate of polling?
Some services don’t like it when you poll too often, so do you have a min spec on how often we’re allowed to poll the service?
b) statusschedule.php/running/water is documented as a String, is this correct?
Also, what is the baseline “date” that’s used for the water consumed? Is it the total amount of water used ever, or each day/week/month?
c) statusschedule.php/master is documented as type “seconds”, I think it should be “integer”
d) statusschedule.php/running/water is the only place to ‘read’ the flow meter.
So it looks like I can only read the attached flow meter when a watering cycle is in process. How do I go about reading it when the cycle isn’t running.
ie. Water leaks due to broken valves (etc) - since a single flow meter will cover all of my valves
This is my primary reason for replacing the system (a $400 water bill a few yrs back, due to a stuck valve)
e) Some of the time fields are EPOCH (integer) and some are string, is this intentional?
If they’re String, what TZ and format are they? In some cases, the units are seconds, and in others they’re minutes or something else.
eg. run, time, timestr, nicetime, last_contact, watering_time, time_left
Do you have some sample JSON output that can be used as a reference? I can work off the live stream, but prefer to work against a documented (vs observed) behavior for this type of stuff - esp when i18n might come into play.
f) Where’s the best place to provide API feedback?