Table of Contents


Notifications for automatic deletion of zones

The "zone purge" operation is the automatic deletion of zones that are no longer in use. When the operation is completed, a notification is sent to the main user.

Details on zone purge can be found here.

Trigger of the notification

This process runs automatically in the background using a cron job. The process is not triggered by an AutoDNS task.
The following conditions must be met for the notification to be sent:

  1. The zone must have the purge status AUTO.
  2. The domain belonging to the zone has not been in the inventory for 60 days.
  3. In the AutoDNS user profile, the checkbox next to Purge Notifications must be checked.

→ User Settings → User Profile → API Settings → System Notifications → Purge Notifications

Recipient of the notifications

The notifications are sent to the user who has the zone in his or her inventory.

Notification when contacts of subusers are deleted

If the contacts of a subuser are deleted, the notifications are only sent to the subuser by default. If they should also be sent to the main user, this can be set in the user profile of the main user.

→ User Profile → API Settings → System Notifications → Subuser Notifications

Examples

Polling notification examples

JSON
{
   "stid":"20220610-app4-226953",
   "status":{
      "code":"S0905",
      "text":"The notification was polled successfully.",
      "type":"SUCCESS"
   },
   "object":{
      "type":"Message",
      "value":"64774886",
      "summary":1
   },
   "data":[
      {
         "id":64774886,
         "notify":{
            "type":"contact_deleted",
            "object":{
               "type":"Contact",
               "data":{
                  "id":12345
               }
            }
         }
      }
   ]
}
XML
<response>
   <result>
      <data>
         <summary>1</summary>
         <message>
            <id>1005420303</id>
            <owner>
               <user>normal_user</user>
               <context>4</context>
            </owner>
            <notify>
               <handle>
                  <id>23307801</id>
               </handle>
               <type>contact_deleted</type>
               <msg>
                  <code>MSG01039</code>
                  <type>notice</type>
               </msg>
               <status>
                  <code>S0303</code>
                  <type>success</type>
               </status>
               <created>2021-05-10 15:06:16</created>
            </notify>
            <created>2021-05-10 15:06:16</created>
         </message>
      </data>
      <status>
         <code>S0905</code>
         <text>The notification was polled successfully.</text>
         <type>success</type>
         <object>
            <type>message</type>
            <value>1005420303</value>
         </object>
      </status>
   </result>
   <stid>20210510-app3-dev-9688</stid>
</response>

Push notification examples

JSON
{
   "stid":"20220610-app4-226953",
   "status":{
      "code":"S0905",
      "text":"The notification was polled successfully.",
      "type":"SUCCESS"
   },
   "object":{
      "type":"Message",
      "value":"64774886",
      "summary":1
   },
   "data":[
      {
         "id":64774886,
         "notify":{
            "type":"contact_deleted",
            "object":{
               "type":"Contact",
               "data":{
                  "id":12345
               }
            }
         }
      }
   ]
}



XML
<response>
	<result>
		<data>
			<summary>1</summary>
			<message>
				<handle>
					<id>23308053</id>
				</handle>
				<type>zone_deleted</type>
				<msg>
					<code>MSG01039</code>
					<type>notice</type>
				</msg>
				<status>
					<code>S0303</code>
					<type>success</type>
				</status>
				<id>1005452585</id>
				<created>2021-05-11 10:53:21</created>
			</message>
		</data>
		<status>
			<code>S0905</code>
			<text>The notification was polled successfully.</text>
			<type>success</type>
			<object>
				<type>message</type>
				<value>1005420303</value>
			</object>
		</status>
	</result>
	<stid>20210510-app3-dev-9688</stid>
</response>