Create monitoring notification
Name | Data Type | Status | Description |
auth-id | Integer | Required | Authentication parameter |
auth-password | String | Required | Authentication parameter |
id | Integer | Required | The ID of the monitoring check |
type | String | Required | The type of notification. It can be either webhook-up, webhook-down, mail, sms, telegram or discord |
code | String | Optional | The phone code of your mobile number for SMS notifications. The Telegrams BotToken or the Discords Token. |
value | String | Required | The notification email,URL address, phone number or custom message |
chat-id | String | Optional | The Telegrams chat Id, or Discords channel Id |
When the authenctication of API user is not correct, any API request will fail with the following status and statusDescription:
{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}
When the record-id is incorrect or missing, any API request will fail with the following status and statusDescription:
{"status":"Failed","statusDescription":"Invalid request."}
When the type of the notification is incorrect, any API request will fail with the following status and statusDescription:
{"status":"Failed","statusDescription":"Invalid notification type."}
Note: These are example errors in JSON format.
URL JSON: https://api.cloudns.net/monitoring/add-notification.json
Domain POST/GET: auth-id=0&auth-password=password&id=125&type=webhook-up&value=https://example.com
URL XML: https://api.cloudns.net/monitoring/add-notification.xml
Domain POST/GET: auth-id=0&auth-password=password&id=125&type=webhook-up&value=https://example.com