Set custom mail subject

Description

Sets a custom mail subject for a specific monitoring check


Parameters

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
subject String Optional If this parameter is missing or it is wrong, sets the default mail subject. With this parameter, you can set a custom mail subject by using these variables:
  • {STATUS} - Current monitoring status
  • {NAME} - Name of the monitoring check
  • {IP} - Monitored IP address
  • {TYPE} - Monitoring type e.g. HTTPS
  • {REGION} - Region where the check is monitored
Note: The variables must be written in the same way shown here(with capital letters) in order for them to work and send the correct data!

Response: Status and message.


Errors

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."}

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/monitoring/set-custom-subject.json
Domain POST/GET: auth-id=0&auth-password=password&id=125&subject=My custom mail subject - {NAME} {IP} {STATUS}

URL XML: https://api.cloudns.net/monitoring/set-custom-subject.xml
Domain POST/GET: auth-id=0&auth-password=password&id=125&subject=My custom mail subject - {NAME} {IP} {STATUS}


Last modified: 2023-10-31
Cookies帮助我们提供我们的服务。通过使用我们的服务,您同意我们使用cookies。 了解更多