extern/apprise-api
1
0
Fork 0
mirror of https://github.com/caronc/apprise-api.git synced 2024-12-12 18:00:51 +01:00
Code Issues Packages Projects Releases Wiki Activity

Added API HTTP Return Code Documentation (#160)

Browse Source
This commit is contained in:
Chris Caron 2023-12-28 16:23:24 -05:00 committed by GitHub
parent 19a48a67c5
commit a80ca0ae60
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -272,6 +272,17 @@ curl -X POST -d '{"tag":"leaders teamA, leaders teamB", "body":"meeting now"}' \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
http://localhost:8000/notify/projectX http://localhost:8000/notify/projectX
``` ```
### API Response Codes
| HTTP Code | Name | Effect |
| ---------- | --------------------- | ------------------------------ |
| 200 | ok | Notification was sent
| 204 | no content | There was no configuration (or it was empty) found by the specified `{KEY}`
| 400 | bad request | Your API call did not conform to what was documented here
| 405 | method not accepted | Your API call identified an action that has been disabled due to the Server configuration (such as a `apprise://` `APPRISE_RECURSION_MAX` being exceeded).
| 424 | failed dependency | At least one notification could not be sent. This can be due to<br/> - Not all notifications intended to be actioned could follow through (due to upstrem failures).<br/>You didn't idenify a tag associated with what was defined in your configuration.<br/>The tag(s) you specified do not match with those defined in your configuration.
| 500 | internal server error | This can occur if there was an issue saving your configuration to disk (usually the cause of permission issues).
### API Notes ### API Notes