If the configuration parameter is 0 or not set, the pause will stay on until you press the button again (i.e., there is no automatic timeout). Please open up the API (for free) to developers who own and want to use their device in their house(s). Use Git or checkout with SVN using the web URL. With the Streamlabs API you can access various aspects of a user's Streamlabs account and even trigger custom alerts! This could happen at odd hours and maybe even when the home owner is away. You can always update your selection by clicking Cookie Preferences at the bottom of the page. Also this allows (untested) for a second Service Manager to be installed with a unique name to handle a home that has 2 SmartLabs devices. You should also have already created a StreamLabs account and successfully installed the Water Meter with its App. Basic HTTP authorization header. We plan to adjust our subscription details based on customer feedback and I have passed your concerns along to our team. Follow the instructions on the Streamlabs Getting Started page to request your API key. A custom home automation system may tell Streamlabs to go into home mode right before turning the water on to the lawn and then go back to away mode when it has shut the water off. Get a Subscription; Get all Subscriptions; Get all Location Subscriptions; Delete a Subscription; Getting Started. A location_id is required to fetch details of a location, water usage and for updating homeAway. Sprinklers may be automated to water a lawn when it is dry. In order to access the data, you must use the cloud based servers. Select Accept all to consent to this use, Reject all to decline this use, or More info to control your cookie preferences. We use cookies and similar technologies ("cookies") to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. &client_id={client_id} For additional information on these standard SmartThings installation practices, some suggested documentation includes: You will need to request an API key for your account from StreamLabs. If it is found, the Device Handler will then be automatically installed within about 30 seconds. Send read-only stuff like consumption/flow rate every minute over udp to a local IP address. If enough water evaporates the pool can be set to fill. The library supports the API key mode of authentication, so make sure you follow the steps to request that (OAUTH2 is not currently supported). Obtain API Key; Make a test request; Create a HTTP Client; Step 1: Obtain API Key . When the StreamLabs device is installed, you provided a name to be given to the location. That is, go to the "Automation" page and the "SmartApps" tab. Currently you can only update the homeAway mode of the location It increase burden on user side but at least it won't cost them extra server traffic. hosted on the device as we can find on many home bridges) it would be better for privacy, product life cycle, performances. This button requests an update from the StreamLabs cloud of water usage and Home/Away state. Good point, alternatively maybe they can provide a callback option, which sends data from mobile app to your own server. Python 100.0%; Branch: master New pull request Find file. I was not able to determine a method to subscribe for StreamLabs alerts using an API Key interface (I assume a mechanism doesn't exist). I am on the fence for purchase of this device, looking into whats out there in water monitors, an open API (local to unit sounds great) would defiantly sell this unit for me. response_type=code We use essential cookies to perform essential website functions, e.g. StreamLabs customers can gain access to the StreamLabs API by subscribing to the StreamPlus subscription service. Please let me know if you have any additional questions or concerns and feel free to reach out to us at support@streamlabswater.com. Facebook; Twitter; LinkedIn; 1 Comments 1 comment. This could happen at odd hours and maybe even when the home owner is away. In the SmartThings IDE, select the newly installed "StreamLabs Water Flow SM" on the "My SmartApps" page. You signed in with another tab or window. At least building an IFTTT connector might be a simpler alternative. If we continue to see increased demand for a direct device API, we will certainly look at adding it as a feature. Learn more. A paragraph that briefly describes what your application does and how you'll use the api. When SmartThings mode changes to one of the selected items, then the StreamLabs status will be changed to "Away". This allows StreamLabs alerts to be interfaced to other SmartApps such as Smart Home Monitor. SmartLabs would benefit from increased sales to Smartthings users which would easily offset the lack of subscription fee income (these types of subscription-based business models have mostly failed in the past). The package needs to configured with your accounts API Key available when you login into your http://my.streamlabswater.com account. If nothing happens, download Xcode and try again. How can I get API access? Not a very developer friendly system. StreamLabs Control uses patented ultrasonic technology to monitor water distribution and usage in real-time, detect leaks, and shut off the water source automatically if a leak is detected. Learn more. You will need an active StreamPlus™ subscription with API support in order to view your apiKey and use the API. This API allows you to: Seamlessly integrate StreamLabs unique water monitoring system with your existing system (s). Matt Miraglia December 18, 2018 12:30; Great to hear that there is an API. This again can be at an unexpected time, completely normal and would flag as a leak if it turned on while in away mode. Refer to the StreamLabs documentation on this functionality but in a nutshell, when it is "Away" a flow alert is posted after about 15 seconds of any amount of water flow. Introduction ; Getting Started ; HTTP Overview ; Guides. Thank you for your feedback. Yeah without an API the only use case of the device for me right now is leak detection, a public API would be great so we can integrate it with other services. Perhaps you reset your api token? StreamLabs Water Flow Meter interface for SmartThings. Use the standard SmartApp installation methods to install the Service Manager in the Phone App. Really love the product and it a great idea but the lack of an API sucks :(, -H ' Host: api.streamlabs.io' -H 'accept: application/json' -H 'content-type: application/json' -H 'x-amz-security-token: ' -H 'accept-language: en-us' -H 'x-amz-date: 20180407T041809Z' -H 'utc-offset: -7' -H 'user-agent: aws-sdk-iOS/2.6.1 iOS/11.2.6 en_US' -H 'authorization: AWS4-HMAC-SHA256 Credential=, SignedHeaders=accept;content-type;host;user-agent;utc-offset;x-amz-date;x-amz-security-token, Signature=' --compressed 'https://api.streamlabs.io/v1/locations/$$$$$/trends'. they're used to gather information about the pages you visit and how many clicks you need to accomplish a task. This is an unofficial Classic SmartThings interface to the StreamLabs Smart Home Water Meter. We're excited to announce the launch of our API Beta program! We will continue to discuss it as we work to improve our products. To learn more about our use of cookies see our Privacy Statement. This Device Handler implements a standard water leak sensor device; as such this is read only and you cannot override the status. Learn more, We use analytics cookies to understand how you use our websites so we can make them better, e.g. You can always update your selection by clicking Cookie Preferences at the bottom of the page. Unofficial Python library for the StreamLabs Water API 5 commits 1 branch 0 packages 0 releases Fetching contributors Apache-2.0 Python. I picked this as a compromise to not overload the cloud but to also receive timely events. This will take some days for StreamLabs to approve your request. The following retrieves the locationId for the first available location: With this we can now query the current water usage summary: Or retrieve the current away mode for the location: Finally we can use the locationId to change the away mode for the location: We use cookies and similar technologies ("cookies") to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. The Home/Away status defines different algorithms within the Water Meter to determine if there is a leak. Select Accept all to consent to this use, Reject all to decline this use, or More info to control your cookie preferences. We use cookies and similar technologies ("cookies") to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. The easiest way to install the library is via pip: Usage is pretty simple but you can check out some sample usage via the examples directory. In today's environment a closed ecosystem is doomed to fail. This method will throw an Exception if the delete fails else returns a None. Scroll to the bottom and select "Add a SmartApp". Location for discussing the Streamlabs API. Learn more. We use cookies and similar technologies ("cookies") to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Once you recieve the confirmationToken via your endpoint, update the subscription to start recieving alerts. To receive OAuth2 credentials, send an email to support@streamlabswater.com with a subject of OAuth 2 Client Request and the following information in the body: Once your request has been approved we will provide you with a client_id and a client_secret, In order to start making requests you will also need the StreamLabs auth domain https://auth.streamlabswater.com and the redirect_uri you provided in your credentials request. You will need an active StreamPlus™ subscription with API support in order to view your apiKey and use the API. This will cause the Device Handler to start a countdown to ignore any StreamLabs alerts for the number of minutes set in the Device Handler configuration ("# of minutes for Pause"). A good example of allowing users to access the API for development is Samsung SmartThings. OAuth 2.0 is typically used in situations where a company wants to link a user in their system to a StreamLabs Customer. For example, connecting your Amazon Alexa account to your StreamLabs account by signing in with your StreamLabs credentials. I agree charging for services provided by Streamlabs that require the use of the API, such as downloading data is fair but if the end user has the wherewithal to access the API and manipulate the data without the services of StreamLabs that should remain free. Note that the ability to delay (Pause) SmartThings declaring a water leak from a StreamLabs alert is an added feature of this implementation. Streamlabs API Beta; API Integrate to Homeseer Follow. The StreamLabs API runs in the "cloud"; for SmartThings to interrogate cloud interfaces, it requires two pieces: both a Device Handler and a Service Manager (a special kind of SmartApp). Then IFTTT and finally a real public REST API. We use cookies and similar technologies ("cookies") to provide and secure our websites, as well as to analyze the usage of our websites, in order to offer you a great user experience. Matt. At the very minimum you need to provide a startTime for the reading you want to retrive. I'll grab a "Slabs Water Monitor" and see if I can bring the data into Homeseer3. To learn more about our use of cookies see our Privacy Statement. The key is a base64 representation of the client_id and client_secret, concatenated with a colon. The value entered here is how long the pause will stay in effect. That practice has propelled that user base into the millions because of the huge amount of 3rd party development and support of that platform because of the free an open API. This will cause the Device Handler to start a countdown to ignore any StreamLabs alerts for the number of minutes set in the Device Handler configuration ("# of minutes for Pause"). You can use any of the popular HTTP Clients in your web site or node project. Your client can now make calls to the StreamLabs® developer API with an Authorization header of type Bearer.