gotify

class platypush.plugins.gotify.GotifyPlugin(server_url: str, app_token: str, client_token: str, **kwargs)[source]

Gotify integration.

Gotify allows you process messages and notifications asynchronously over your own devices without relying on 3rd-party cloud services.

Triggers:

__init__(server_url: str, app_token: str, client_token: str, **kwargs)[source]
Parameters
  • server_url – Base URL of the Gotify server (e.g. http://localhost).

  • app_token – Application token, required to send message and retrieve application info. You can create a new application under http://<server_url>/#/applications.

  • client_token – Client token, required to subscribe to messages. You can create a new client under http://<server_url>/#/clients.

delete_messages(*ids)[source]

Delete messages.

Parameters

ids – If specified, it deletes the messages matching these IDs. Otherwise, it deletes all the received messages.

get_messages(limit: int = 100, since: Optional[int] = None)[source]

Get a list of the messages received on the server.

Parameters
  • limit – Maximum number of messages to retrieve (default: 100).

  • since – Retrieve the message having since as minimum ID.

Returns

[
  {
    "appid": 1,
    "date": "2021-10-17T01:00:26.814707+00:00",
    "extras": {
      "home::appliances::lighting::on": {
        "brightness": 15
      },
      "home::appliances::thermostat::change_temperature": {
        "temperature": 23
      }
    },
    "id": 1,
    "message": "Test message",
    "priority": 2,
    "title": "Test title"
  }
]

send_message(message: str, title: Optional[str] = None, priority: int = 0, extras: Optional[dict] = None)[source]

Send a message to the server.

Parameters
  • message – Message body (Markdown is supported).

  • title – Message title.

  • priority – Message priority (default: 0).

  • extras – Extra JSON payload to be passed on the message.

Returns

{
  "appid": 1,
  "date": "2021-10-17T01:00:26.814707+00:00",
  "extras": {
    "home::appliances::lighting::on": {
      "brightness": 15
    },
    "home::appliances::thermostat::change_temperature": {
      "temperature": 23
    }
  },
  "id": 1,
  "message": "Test message",
  "priority": 2,
  "title": "Test title"
}