Pushover
Send Pushover notifications
Minimal example:
>>> from notifiers import get_notifier
>>> pushover = get_notifier('pushover')
>>> pushover.notify(message='Hi!', user='USER', token='TOKEN')
You can view the sounds you can user in the notification via the sounds
resource:
>>> pushover.sounds(token='SECRET')
['pushover', 'bike', 'bugle', 'cashregister', 'classical', 'cosmic', 'falling', 'gamelan', 'incoming', 'intermission', 'magic', 'mechanical', 'pianobar', 'siren', 'spacealarm', 'tugboat', 'alien', 'climb', 'persistent', 'echo', 'updown', 'none']
You can view the limits of your application token using the limits
resource:
>>> pushover.limits(token='SECRET')
{'limit': 7500, 'remaining': 6841, 'reset': 1535778000, 'status': 1, 'request': 'f0cb73b1-810d-4b9a-b275-394481bceb74'}
Full schema:
additionalProperties: false
properties:
attachment:
format: valid_file
title: an image attachment to send with the message
type: string
callback:
format: uri
title: a publicly-accessible URL that our servers will send a request to when
the user has acknowledged your notification. priority must be set to 2
type: string
device:
oneOf:
- items:
title: your user's device name to send the message directly to that device
type: string
minItems: 1
type: array
uniqueItems: true
- title: your user's device name to send the message directly to that device
type: string
expire:
maximum: 86400
title: how many seconds your notification will continue to be retried for. priority
must be set to 2
type: integer
html:
title: enable HTML formatting
type: boolean
message:
title: your message
type: string
priority:
maximum: 2
minimum: -2
title: notification priority
type: integer
retry:
minimum: 30
title: how often (in seconds) the Pushover servers will send the same notification
to the user. priority must be set to 2
type: integer
sound:
title: the name of one of the sounds supported by device clients to override the
user's default sound choice. See `sounds` resource
type: string
timestamp:
format: timestamp
minimum: 0
title: a Unix timestamp of your message's date and time to display to the user,
rather than the time your message is received by our API
type:
- integer
- string
title:
title: your message's title, otherwise your app's name is used
type: string
token:
title: your application's API token
type: string
url:
format: uri
title: a supplementary URL to show with your message
type: string
url_title:
title: a title for your supplementary URL, otherwise just the URL is shown
type: string
user:
oneOf:
- items:
title: the user/group key (not e-mail address) of your user (or you)
type: string
minItems: 1
type: array
uniqueItems: true
- title: the user/group key (not e-mail address) of your user (or you)
type: string
required:
- user
- message
- token
type: object