Suche in diesem Bereich

Skip to end of metadata
Go to start of metadata
Inhaltsverzeichnis dieser Seite

Funktion

Der Auftragstyp ContactCreate legt einen neuen Kontakt an.

Beschreibung

Wenn Sie aus verwaltungstechnischen Gründen einen Kontakt mit gleichem Namen mehrmals benötigen, muss dies im Request angegeben werden.
In XML müssen Sie den Key <key>force_handle_create</key> unterhalb von <task> einfügen.
In JSON müssen Sie die Route folgendermaßen ergänzen /contact?keys[]=force_handle_create.

Route: POST /contact

Request
{
   "alias": "petermuster",
   "type": "PERSON",
   "organization": "Company",
   "title": "Dr.",
   "city": "Musterstadt",
   "country": "DE",
   "state": "BY",
   "email": "petermuster@example.com",
   "fname": "Peter",
   "lname": "Muster",
   "address": [
      "123 Musterstrasse"
   ],
   "pcode": "12345",
   "phone": "+49-123-12345",
   "fax": "+49-123-12345"
}
Response
{
    "stid": "20190628-app3-dev-11529",
    "status": {
        "code": "S0301",
        "text": "Domain-Kontakt wurde erfolgreich angelegt.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "value": "23151437"
    },
    "data": [
        {
            "created": "2019-06-28T14:52:48.000+0200",
            "updated": "2019-06-28T14:52:48.000+0200",
            "id": 23151437,
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "updater": {
                "context": 4,
                "user": "customer"
            },
            "alias": "petermuster",
            "type": "PERSON",
            "organization": "Company",
            "title": "Dr.",
            "city": "Musterstadt",
            "country": "DE",
            "state": "BY",
            "email": "petermuster@example.com",
            "protection": "SHOW_NONE",
            "fname": "Peter",
            "lname": "Muster",
            "address": [
                "Musterstrasse"
            ],
            "pcode": "12345",
            "phone": "+49-123-12345",
            "fax": "+49-123-12345"
        }
    ]
}

Auftragstyp-Code: 0301
Verwendet Objekt Contact

Request
<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0301</code>
        <handle>
            <alias></alias>
            <type>PERSON</type>
            <fname>Peter</fname>
            <lname>Muster</lname>
            <organization>PDA</organization>
            <address>Musterstrasse</address>
            <pcode>12345</pcode>
            <city>Musterstadt</city>
            <state>BY</state>
            <country>DE</country>
            <phone>+49+1-12345-12345</phone>
            <fax>+49+1-12345-12345</fax>
            <email>Muster@example.com</email>
            <protection>B</protection>
            <nic_ref>de</nic_ref>
            <extension>
                <idnumber>T22000129</idnumber>
            </extension>
        </handle>
        <reply_to>customer@example.com</reply_to>
    </task>
</request>
Response
<response>
	<result>
		<status>
			<code>N0301</code>
			<text>Das Anlegen des Domain-Kontaktes wurde gestartet.</text>
			<text></text>
			<type>notify</type>
			<object>
				<type>handle</type>
				<value>9926612</value>
			</object>
		</status>
	</result>
</response>

Mögliche Fehlermeldungen

  • EF03010 - Ungueltige Telefonnummer.
  • EF03011 - Ungueltige Faxnummer.
  • EF030110 - Es müssen ID oder Alias des Domain-Kontaktes angegeben werden.
  • EF03012 - Die Anmerkungen sind zu lang.
  • EF03013 - Interner Fehler - NIC-Member-ID des Root-Benutzers konnte nicht ermittelt werden.
  • EF03014 - Ungueltiger Domain-Kontakt.
  • EF03015 - Die Anzahl der maximal erlaubten Zeichen ist ueberschritten.
  • EF03016 - Der Benutzer ist fuer diesen Domain-Kontakt nicht berechtigt.
  • EF03017 - Ungueltiger Vorname.
  • EF03018 - Ungueltiger Nachname.
  • EF03019 - Ungueltige Organisation.