Pushover Glances API (Beta) With Pushover's Glances API, you can push small bits of data directly to a constantly-updated screen, referred to as a widget, such as a complication on your smart watch or a widget on your phone's lock screen. This API is separate from our Message API since it does not generate push notification alerts or sounds, and messages are not stored in the Pushover clients. Our Glances API is used for sending short pieces of text or numerical data, such as "Garage door open" in response to an alarm system, or just "30" representing the number of items sold in your store today. These pieces of data should be low-priority since they often cannot get updated in real-time or very frequently, and they must be concise because they are often viewed on small screens such as a watch face. Please note that our Glances API is currently in beta and may be subject to change.

Widgets Each screen showing glance data is referred to as a widget, and currently widgets must be attached to devices that run our iOS and Android clients. When performing a Glance API call for a user, the user must have a widget already registered on their device, which is done automatically when creating the widget or adding the Pushover complication to Apple Watch. You can see the status of your registered widget on your dashboard under Your Devices. Note: at this time, the Apple Watch is the only supported widget. Android and iOS widgets will be supported in future versions of our apps.

Limitations In addition to the per-field limits detailed below, there are platform-specific limitations that must be taken into account: Apple Watch

Pushing data to the Apple Watch must be done infrequently, or WatchOS will stop processing updates due to battery concerns. Please note that Pushover does not do any throttling of your data updates, so it is up to you to throttle your Glances API calls. When sending data to the Apple Watch, we recommend at least 20 minutes between each call. If you have pushed too much data and WatchOS stops processing updates, this resets overnight. Remember, the data presented through our Glances API should be low-priority (something to be occasionally glanced at). If you need to send data that is delivered right away and presented to the user, use our Messages API.

Available Data Fields Currently the following fields are available for updating. Each field is shown differently on different screens, so you may need to experiment with them to find out which field works for you given your screen and type of data. For example, each watch face on the Apple Watch uses a different sized complication, with different size specifications and types of data. Some are text strings, some are just numbers. title (100 characters) - a description of the data being shown, such as "Widgets Sold"

(100 characters) - a description of the data being shown, such as "Widgets Sold" text (100 characters) - the main line of data, used on most screens

(100 characters) - the main line of data, used on most screens subtext (100 characters) - a second line of data

(100 characters) - a second line of data count (integer, may be negative) - shown on smaller screens; useful for simple counts

(integer, may be negative) - shown on smaller screens; useful for simple counts percent (integer 0 through 100, inclusive) - shown on some screens as a progress bar/circle