[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/zzeneg/apprise-api/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","zzeneg","reponame","apprise-api","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-02-10T12:41:01.197832Z","description","","is_private","last_updated","2020-02-10T13:06:30.528439Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",3383,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Apprise API\n\nTake advantage of [Apprise](https://github.com/caronc/apprise) through your network with a user-friendly API.\n\n- Send notifications to more then 50+ services.\n- An incredibly lightweight gateway to Apprise.\n- A production ready micro-service at your disposal.\n\nApprise API was designed to easily fit into existing (and new) eco-systems that is looking for a simple notification solution.\n\n[![Paypal](https://img.shields.io/badge/paypal-donate-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MHANV39UZNQ5E)\n[![Follow](https://img.shields.io/twitter/follow/l2gnux)](https://twitter.com/l2gnux/)
\n[![Discord](https://img.shields.io/discord/558793703356104724.svg?colorB=7289DA&label=Discord&logo=Discord&logoColor=7289DA&style=flat-square)](https://discord.gg/MMPeN2D)\n[![Build Status](https://travis-ci.org/caronc/apprise-api.svg?branch=master)](https://travis-ci.org/caronc/apprise-api)\n[![CodeCov Status](https://codecov.io/github/caronc/apprise-api/branch/master/graph/badge.svg)](https://codecov.io/github/caronc/apprise-api)\n[![Docker Pulls](https://img.shields.io/docker/pulls/caronc/apprise.svg?style=flat-square)](https://hub.docker.com/r/caronc/apprise)\n\n## Screenshots\nThere is a small built-in *Configuration Manager* that can be optionally accessed through your web browser accessible via `/cfg/{KEY}`:
\n![Screenshot of GUI - Using Keys](https://raw.githubusercontent.com/caronc/apprise-api/master/Screenshot-1.png)
\n\nBelow is a screenshot of how you can set either a series of URL's to your `{KEY}`, or set your YAML and/or TEXT configuration below.\n![Screenshot of GUI - Configuration](https://raw.githubusercontent.com/caronc/apprise-api/master/Screenshot-2.png)\n\nOnce you've saved your configuration, you'll be able to use the *Notification* tab to send to messages to one or more of the services defined in your configuration. You can use the tag `all` to notify all of your services regardless of what tag had otherwise been assigned to them.\n![Screenshot of GUI - Notifications](https://raw.githubusercontent.com/caronc/apprise-api/master/Screenshot-3.png)\n\nAt the end of the day, the GUI just simply offers a user friendly interface to the API developers can directly interface with if they wish to.\n\n## Installation\nThe following options should allow you to access the API at: `http://localhost:8000/` from your browser.\n\nUsing [dockerhub](https://hub.docker.com/r/caronc/apprise), you can do the following:\n```bash\n# Retrieve container\ndocker pull caronc/apprise:latest\n\n# Start it up:\n# /config is used for a persistent store, you do not have to mount\n# this if you don't intend to use it.\ndocker run --name apprise \\\n -p 8000:8000 \\\n -v /var/lib/apprise/config:/config \\\n -d caronc/apprise:latest\n```\n\nA `docker-compose.yml` file is already set up to grant you an instant production ready simulated environment:\n\n```bash\n# Docker Compose\ndocker-compose up\n```\n\n## Apprise URLs\n📣 In order to trigger a notifications, you first need to create one or more [Apprise URLs](https://github.com/caronc/apprise/wiki). Apprise supports well over 50 notification services today and is always expanding to add support for more! Visit https://github.com/caronc/apprise/wiki to see all of the supported Apprise services and how you can generate your own URLs from them.\n\n## API Details\n\n### Stateless Solution\n\nSome people may wish to only have a sidecar solution that does require use of any persistent storage. The following API endpoint can be used to directly send a notification of your choice to any of the [supported services by Apprise](https://github.com/caronc/apprise/wiki) without any storage based requirements:\n\n| Path | Method | Description |\n|------------- | ------ | ----------- |\n| `/notify/` | POST | Sends one or more notifications to the URLs either specified as part of the payload, or those identified in the environment variable `APPRISE_STATELESS_URLS`.
*Parameters*
📌 **urls**: One or more URLs identifying where the notification should be sent to. If this field isn't specified then it automatically assumes the `settings.APPRISE_STATELESS_URLS` value or `APPRISE_STATELESS_URLS` environment variable.
📌 **body**: Your message body. This is a required field.
📌 **title**: Optionally define a title to go along with the *body*.
📌 **type**: Defines the message type you want to send as. The valid options are `info`, `success`, `warning`, and `error`. If no *type* is specified then `info` is the default value used.\n\nHere is a *stateless* example of how one might send a notification (using `/notify/`):\n```bash\n# Send your notifications directly\ncurl -X POST -d '{\"urls\": \"mailto://user:pass@gmail.com\", \"body\":\"test message\"}' \\\n -H \"Content-Type: application/json\" \\\n http://localhost:8000/notify\n```\n\n### Persistent Storage Solution\n\nYou can pre-save all of your Apprise configuration and/or set of Apprise URLs and associate them with a `{KEY}` of your choosing. Once set, the configuration persists for retrieval by the `apprise` [CLI tool](https://github.com/caronc/apprise/wiki/CLI_Usage). The built in website associated with comes with a user interface that you can usse to leverage these API calls. However those who wish to build their own application around this can use the following API end points:\n\n| Path | Method | Description |\n|------------- | ------ | ----------- |\n| `/add/{KEY}` | POST | Saves Apprise Configuration (or set of URLs) to the persistent store.
*Parameters*
📌 **urls**: Define one or more Apprise URL(s) here. Use a comma and/or space to separate one URL from the next.
📌 **config**: Provide the contents of either a YAML or TEXT based Apprise configuration.
📌 **format**: This field is only required if you've specified the _config_ parameter. Used to tell the server which of the supported (Apprise) configuration types you are passing. Valid options are _text_ and _yaml_.\n| `/del/{KEY}` | POST | Removes Apprise Configuration from the persistent store.\n| `/get/{KEY}` | POST | Returns the Apprise Configuration from the persistent store. This can be directly used with the *Apprise CLI* and/or the *AppriseConfig()* object ([see here for details](https://github.com/caronc/apprise/wiki/config)).\n| `/notify/{KEY}` | POST | Sends a notification based on the Apprise Configuration associated with the specified *{KEY}*.
*Parameters*
📌 **body**: Your message body. This is the *only* required field.
📌 **title**: Optionally define a title to go along with the *body*.
📌 **type**: Defines the message type you want to send as. The valid options are `info`, `success`, `warning`, and `error`. If no *type* is specified then `info` is the default value used.
📌 **tag**: Optionally notify only those tagged accordingly.\n| `/json/urls/{KEY}` | GET | Returns a JSON response object that contains all of the URLS and Tags associated with the key specified.\n\nAs an example, the `/json/urls/{KEY}` response might return something like this:\n```json\n{\n \"tags\": [\"devops\", \"admin\", \"me\"],\n \"urls\": [\n {\n \"url\": \"slack://TokenA/TokenB/TokenC\",\n \"tags\": [\"devops\", \"admin\"]\n },\n {\n \"url\": \"discord://WebhookID/WebhookToken\",\n \"tags\": [\"devops\"]\n },\n {\n \"url\": \"mailto://user:pass@gmail.com\",\n \"tags\": [\"me\"]\n }\n ]\n}\n```\n\nHere is an example using `curl` as to how someone might send a notification to everyone associated with the tag `abc123` (using `/notify/{key}`):\n```bash\n# Send notification(s) to a {key} defined as 'abc123'\ncurl -X POST -d '{\"body\":\"test message\"}' \\\n -H \"Content-Type: application/json\" \\\n http://localhost:8000/notify/abc123\n```\n\n🏷️ You can also leverage _tagging_ which allows you to associate one or more tags with your Apprise URLs. By doing this, notifications only need to be referred to by their easy to remember notify tag name such as `devops`, `admin`, `family`, etc. You can very easily group more then one notification service under the same _tag_ allowing you to notify a group of services at once. This is accomplished through configuration files ([documented here](https://github.com/caronc/apprise/wiki/config)) that can be saved to the persistent storage (Apprise API) supports.\n\n```bash\n# Send notification(s) to a {key} defined as 'abc123'\n# but only notify the URLs associated with the 'devops' tag\ncurl -X POST -d '{\"tag\":\"devops\", \"body\":\"test message\"}' \\\n -H \"Content-Type: application/json\" \\\n http://localhost:8000/notify/abc123\n```\n\n### API Notes\n\n- `{KEY}` must be 1-64 alphanumeric characters in length. In addition to this, the underscore (`_`) and dash (`-`) are also accepted.\n- Specify the `Content-Type` of `application/json` to use the JSON support.\n- There is no authentication (or SSL encryption) required to use this API; this is by design. The intention here to be a lightweight and fast micro-service.\n- There are no additional dependencies should you choose to use the optional persistent store (mounted as `/config`).\n\n### Environment Variables\n\nThe use of environment variables allow you to provide over-rides to default settings.\n\n| Variable | Description |\n|--------------------- | ----------- |\n| `APPRISE_CONFIG_DIR` | Defines an (optional) persistent store location of all configuration files saved. By default:
- Configuration is written to the `apprise_api/var/config` directory when just using the _Django_ `manage runserver` script. However for the path for the container is `/config`.\n| `APPRISE_STATELESS_URLS` | For a non-persistent solution, you can take advantage of this global variable. Use this to define a default set of Apprise URLs to notify when using API calls to `/notify`. If no `{KEY}` is defined when calling `/notify` then the URLs defined here are used instead. By default, nothing is defined for this variable.\n| `SECRET_KEY` | A Django variable acting as a *salt* for most things that require security. This API uses it for the hash sequences when writing the configuration files to disk.\n| `ALLOWED_HOSTS` | A list of strings representing the host/domain names that this API can serve. This is a security measure to prevent HTTP Host header attacks, which are possible even under many seemingly-safe web server configurations. By default this is set to `*` allowing any host. Use space to delimit more then one host.\n| `DEBUG` | This defaults to `False` however can be set to `True` if defined with a non-zero value (such as `1`).\n\n\n## Development Environment\n\nThe following should get you a working development environment to test with:\n\n```bash\n# Create a virtual environment in the same directory you\n# cloned this repository to:\npython -m venv .\n\n# Activate it now:\n. ./bin/activate\n\n# install dependencies\npip install -r dev-requirements.txt -r requirements.txt\n\n# Run a dev server (debug mode) accessible from your browser at:\n# -> http://localhost:8000/\n./manage.py runserver\n```\n\nSome other useful development notes:\n\n```bash\n# Check for any lint errors\nflake8 apprise_api\n\n# Run unit tests\npytest apprise_api\n```\n\n## Apprise Integration\n\n### Apprise CLI Pull Example\n\nA scenario where you want to poll the API for your configuration:\n\n```bash\n# A simple example of the Apprise CLI\n# pulling down previously stored configuration\napprise --body=\"test message\" --config=http://localhost:8000/get/{KEY}\n```\n\n### AppriseConfig() Pull Example\n\nUsing the [Apprise Python library](https://github.com/caronc/apprise), you can easily pull your saved configuration off of the API to use for future notifications.\n\n```python\nimport apprise\n\n# Point our configuration to this API server:\nconfig = apprise.AppriseConfig()\nconfig.add('http://localhost:8000/get/{KEY}')\n\n# Create our Apprise Instance\na = apprise.Apprise()\n\n# Store our new configuration\na.add(config)\n\n# Send a test message\na.notify('test message')\n```\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",252497743,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",5417551,"full_size",252484464,"id",85955439,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:b0855ba03595bc0195da2ec1e4a31c60c7a7fef21e932b3361a0058fb3a18e5f","features","last_pulled","2026-09-24T23:00:38.817055752Z","last_pushed","2020-02-10T12:56:03Z","os","linux","os_features","os_version","size","variant","2020-02-10T13:06:30.026922Z","last_updater","last_updater_username","media_type","latest","repository",8457664,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

zzeneg/apprise-api

Tags for zzeneg/apprise-api