AutoDNS messages

For each job sent to AutoDNS, the system responds with feedback on the processing status of the job in the system (job) and the status of completion of the specific job (task). Depending on the job type, only system responses are returned in real time or additional system notifications. The delivery type email, push or polling can be selected for the system notifications.

Message types in AutoDNS

System responses

• Realtime system responses: These responses are returned directly after an request has been sent.

  • Success (S): Request was successfully completed.

    Error (E): Error during processing with specific error message (EF, e.g. “EF0101”).

    Notify (N): Order has been accepted and is being processed further. The final status is transmitted later via notifications (Success/Error). Example

Notifications

• Internal notifications via polling, push or email: Result from orders with “Notify” status (N). These notifications transmit the final status (success/error) after processing has been completed.

• External notifications: External events (e.g. from a registry) trigger messages that are not assigned to an internal job.

Notification types

Internal notifications via polling, push or email

These messages are directly associated with a job in the system.

• Status types
  

  • Success (S): Job was succesfully processed
    

  • Failed (F): Job failed
    

  • Running: Only for special tasks, e.g transferIn. Indicates, that the job ist still in process.
    

See: Request examples for  Domain jobs, contact jobs, ownerchange jobs und transfer jobs.

Externally triggered notifications

These messages are triggered by external events without reference to an internal task.

List of external notifications

TransferOut

• transfer_start - Start of an outgoing domain transfer.
• transfer_autoack - Automatic confirmation of an outgoing domain transfer (AutoAck). Only for gTLDs.
• transfer_autonack - Automatic refusal of an outgoing transfer (AutoNack).
• transfer_reminder - Reminder of an ongoing transfer.
• domain_away - Deletion of a domain from the database, e.g. in the case of domain transfers without the participation of the registrar.

Domain AutoUpdate

• autoupdate_dns_error- Successful execution of an automatic update. Only for .de domains. An automatic update is only performed if the connectivity check, which is part of the registration process, has failed.
• autoupdate_dns_success - Successful connectivity check.
• autoupdate_deferred_success - Successful deferred AutoUpdate.
• autoupdate_deferred_error - Failed deferred AutoUpdate.

OCVAL (OwnerC validation)

• ocval_reminder - Reminder to deactivate the domain (5 days before).
• ocval_activation - Information about the disconnection of the name servers and the non-accessibility of the domain.
• ocval_deactivation - Information about the reconnection of the nameservers and the re-accessibility of the domain.

Purge notifications

• zone_deleted - zone successfully deleted

• contact_deleted - contact successfully deleted

Examples for messages

System responses

        <status>
            <type>success</type>
            <code>S0301</code>
            <text>The domain contact was updated successfully.</text>
        </status>

    "status": {
        "resultCode": "S0301",
        "text": "The domain contact was updated successfully.",
        "type": "SUCCESS"

External notifications

{
    "notification": {
        "type": "transfer_start",
        "domain": "example.com",
        "timestamp": "2024-12-30T12:00:00Z"
    }
}

  <notification>
    <type>zone_deleted</type>
    <zone>example.com</zone>
    <timestamp>2024-12-30T12:00:00Z</timestamp>
</notification>

Messaging process

• Job start
  

  • System response „success“, „error“ oder „notify“ is returned.
    

• Notify process
  • With the  “Notify” status of the sxstem response, the final status "success" or "error" is transmitted via a notification.

• External events
  

  • Direct notification of events outside the system (e.g. transferOut, zone purge).

See: Schematic representation of order processing for domains and domain contacts, zones, users and inquire jobs, transfer and ownerchange.

Notification structure and keywords (XML)