Help Center
Login Sign up
  1. Start
  2. API-Referenz
  3. Allgemeine API-Grundlagen
  4. Nachrichten im AutoDNS
  5. Beispiele für Benachrichtigungen

Benachrichtigungen bei Kontakt-Aufträgen

API-Referenz (XML/JSON) · Aktualisiert 2024-12-30

Kontakt erfolgreich angelegt

{
    "stid": "20220405-app2-dev-82599",
    "status": {
        "code": "S0301",
        "text": "Domain-Kontakt wurde erfolgreich angelegt.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    },
    "data": [
        {
            "created": "2022-04-05T10:57:17.000+0200",
            "updated": "2022-04-05T10:57:17.000+0200",
            "id": 23377983,
            "owner": {
                "context": 4,
                "user": "exampleuser"
            },
            "updater": {
                "context": 4,
                "user": "exampleuser"
            },
            "alias": "John-Doe-12xx5678",
            "type": "PERSON",
            "organization": "CompanyExample",
            "title": "Dr.",
            "city": "Anytown",
            "country": "DE",
            "state": "BY",
            "email": "john.doe@domain.com",
            "protection": "SHOW_NONE",
            "remarks": [
                "example remark"
            ],
            "domainsafe": false,
            "lname": "Examplelastname",
            "address": [
                "2500 Example Street"
            ],
            "pcode": "12345"
        }
    ]
}

Kontakt anlegen fehlgeschlagen

{
    "stid": "20220405-app3-dev-6802",
    "messages": [
        {
            "text": "Es ist bereits eine Domain-Kontakt mit diesem Namen vorhanden.",
            "objects": [
                {
                    "type": "alias",
                    "value": "John-Doe-12xx5678"
                }
            ],
            "code": "EF03027",
            "status": "ERROR"
        }
    ],
    "status": {
        "code": "E0301",
        "text": "Domain-Kontakt konnte nicht angelegt werden.",
        "type": "ERROR"
    }
}

Kontakt erfolgreich aktualisiert

{
    "stid": "20220405-app3-dev-6872",
    "status": {
        "code": "S0302",
        "text": "Domain-Kontakt wurde erfolgreich aktualisiert.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    }
}

Kontakt aktualisieren fehlgeschlagen

{
    "stid": "20220405-app2-dev-84784",
    "messages": [
        {
            "text": "Nachname darf nicht geändert werden.",
            "objects": [
                {
                    "type": "string",
                    "value": "Examplelastname"
                }
            ],
            "code": "EF00559",
            "status": "ERROR"
        }
    ],
    "status": {
        "code": "E0302",
        "text": "Domain-Kontakt konnte nicht aktualisiert werden.",
        "type": "ERROR"
    },
    "object": {
        "type": "Contact",
        "value": "23377983"
    }
}

Kontakt erfolgreich gelöscht

Domain-Kontakte, die seit 12 Monaten  nicht mehr verwendet werden, werden automatisch durch einen Cronjob gelöscht.

Das Versenden der Benachrichtigungen muss im AutoDNS eingerichtet werden. Dafür muss  im Benutzerprofil die Checkbox bei  Bereinigungs-Benachichtigungen aktiviert werden (Benutzerverwaltung --> Benutzereinstellungen -->Benutzerprofil → API-Einstellungen → Systembenachrichtigungen)
Der Kontakt darf nicht für eine Domain oder in einem laufenden Auftrag in Verwendung sein.

Beim Fehlschlagen wird keine Benachrichtigung vesendet, da in diesem Fall  der Auftrag vom Backend abgelehnt und damit nicht verarbeitet wird.

{
  "stid": "20220610-app4-226953",
  "status": {
    "code": "S0905",
    "text": "Die Benachrichtigung wurde erfolgreich abgerufen.",
    "type": "SUCCESS"
  },
  "object": {
    "type": "Message",
    "value": "64774886",
    "summary": 1
  },
  "data": [
    {
      "id": 64774886,
      "notify": {
        "type": "contact_deleted",
        "object": {
          "type": "Contact",
          "data": {
            "id": 12345
          }
        }
      }
    }
  ]
}