API Reference
Arreya offers a REST style API. Our API has accepts URL encoded data, form-encoded request bodies, JSON formatted bodies, and uses standard HTTPS responses and authentication.
Authentication
Arreya’s API uses API keys to authenticate requests. Information on locating your API Key can be found at https://arreya.com/kb/how-to-find-your-arreya-api-key/
Alert
https://[YOUR CHANNEL].arreya.com/api/v1/channel/alert?apikey=[YOUR API KEY] |
- [YOUR CHANNEL] – The name of the Arreya channel you want to issue alerts for, information on locating your channel name can be found at https://arreya.com/kb/how-to-find-your-channel-name/
- [YOUR API KEY] – The API key for the channel you want to issue alerts for
- Supports GET and POST requests
- Supports POST of CAP xml
- Supports parameters as url parameters, form data, or JSON post
Parameter | Description |
icon | Optional, available icons – https://fontawesome.com/v4.7/icons/ |
title | Title text |
message | Message body |
color | Optional, controls the text color |
background | Optional, uses CSS color values, can also use images with CSS url property |
timeout | How long the message stays on the display. Send a timeout of 0 to clear any active alerts. |
animation | Optional, animate the icon using one of the animations from https://animate.style/ |
apiKey | Your channel API Key |
Example request URL:
https://[YOUR CHANNEL].arreya.com/api/v1/channel/alert?apikey=[YOUR API KEY]&icon=exclamation-triangle&message=This%20is%20a%20test&background=red&color=white&title=ALERT%20TESTING& timeout=15&animation=wobble |
You can run this simple test in your browser by inserting your API key and your channel name