{"id":20511700,"url":"https://github.com/j0hannesr0th/pushover-api","last_synced_at":"2025-10-17T17:45:27.053Z","repository":{"id":175411039,"uuid":"653818672","full_name":"j0hannesr0th/pushover-api","owner":"j0hannesr0th","description":"A REST-API for Pushover (https://pushover.net) written with plain PHP.","archived":false,"fork":false,"pushed_at":"2023-06-24T13:08:39.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T09:08:12.884Z","etag":null,"topics":["php","pushover","pushover-api"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j0hannesr0th.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-14T20:03:23.000Z","updated_at":"2023-06-14T21:50:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"2700e539-2728-429d-abfb-95331b1aa2b4","html_url":"https://github.com/j0hannesr0th/pushover-api","commit_stats":null,"previous_names":["j0hannesr0th/pushover-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hannesr0th%2Fpushover-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hannesr0th%2Fpushover-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hannesr0th%2Fpushover-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hannesr0th%2Fpushover-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j0hannesr0th","download_url":"https://codeload.github.com/j0hannesr0th/pushover-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242117648,"owners_count":20074434,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["php","pushover","pushover-api"],"created_at":"2024-11-15T20:37:11.061Z","updated_at":"2025-10-17T17:45:26.989Z","avatar_url":"https://github.com/j0hannesr0th.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHP Pushover API Wrapper\n\nA simple PHP wrapper for the Pushover API.\n\n## Setup\n\n1. Add your Pushover application token, user key, and usage token in the `config.json` file:\n\n```json\n{\n    \"usageToken\": \"your-usage-token\",\n    \"apiUrl\": \"https://api.pushover.net/1/messages.json\",\n    \"token\": \"your-pushover-app-token\",\n    \"user\": \"your-pushover-user-key\"\n}\n```\n\n## Usage\n\nYou can interact with the API either by making GET or POST requests.\nReplace \"your-usage-token\" with your actual usage token, \"Hello World\" with your actual message, and https://your-domain.com with the actual URL.\n\n### Minimal Parameters\n\nSend a notification with a message:\n\nUsing cURL with GET:\n\n```bash\ncurl -X GET \"https://your-domain.com?usageToken=your-usage-token\u0026action=send\u0026message=Hello%20World\"\n```\n\nUsing cURL with POST:\n\n```bash\ncurl -X POST -d \"message=Hello World\" \"https://your-domain.com?usageToken=your-usage-token\"\n```\n\n### Retrieve all parameters and all sounds\n\n```bash\ncurl -X GET \"https://your-domain.com?usageToken=your-usage-token\"\n```\n\nList of All Possible Parameters\n- `message`: Your message\n- `attachment`: An image attachment to send with the message\n- `device`: Your user's device name to send the message directly to that device, rather than all of the user's devices\n- `title`: Your message's title, otherwise your app's name is used\n- `url`: A supplementary URL to show with your message\n- `url_title`: A title for your supplementary URL, otherwise just the URL is shown\n- `priority`: -2 to send no notification/alert, -1 to always send as a quiet notification, 1 to display as high-priority and bypass the user's quiet hours, or 2 to also require confirmation from the user\n- `sound`: The name of one of the sounds supported by device clients to override the user's default sound choice. Retrieve the list of all possible sound values by making a GET request without action parameter.\n\nSee the official documentation for more details: https://pushover.net/api\n\n### Prepared actions\n\nIt's possible to add prepared actions to your config. On client side you only have to send the preparedAction parameter.\n\nUsing cURL with GET and prepared action:\n\n```bash\ncurl -X GET 'https://your-domain.com?usageToken=your-usage-token\u0026preparedAction=your-preparedAction-key'\n```\n\n## Security Warning\n\nThis implementation allows for sending notifications via GET requests for the sake of demonstration. However, using GET for operations that change the state of your system (like sending a notification) is not recommended because it can expose sensitive data and allow for potential replay attacks. Please use POST requests for these kinds of operations in a production environment.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0hannesr0th%2Fpushover-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj0hannesr0th%2Fpushover-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0hannesr0th%2Fpushover-api/lists"}