In support of some forthcoming changes to the way rain accumulation is calculated and presented in our apps, we will be pushing an update to the API next week. This message is purposely vague as to exactly what is changing, but that will become clear soon. The goal of this post is to give you enough information to make sure nothing breaks in your apps when we push the changes.
An important reason for this heads-up is that we will be removing two fields from the station observation:
precip_accum_last_24hr - these guys were never officially documented, so hopefully none of your apps are using them. But please let us know if that’s not the case.
The main purpose of this update is the addition of five new elements to the end of the “
obs” array within the SKY observation ("
obs_sky"). That is, this array will be growing from 12 elements to 17 elements with no change to the first 12 elements. You may also notice the addition of several new “
precip_*” fields to the station observation response. Please ignore all of these new values for now. We will explain what they mean soon.
Finally, there will also be some changes to the undocumented, unofficial “Summary Object” found in the AIR and SKY observation, but no one should be using those objects, right? If you are, please let us know ASAP.
Note: These changes only affect the REST and WS interfaces. They do not apply to the UDP interface.
Note also: These changes will not affect all devices at the same time. The number will start small and increase over time.