addPerson

Fügt eine Kontaktperson zum Adressbuch hinzu.

Route /addressbook/addPerson[/:key[/:format]]
Erforderliche Parameter firstname (POST)
lastname (POST)
Optionale Parameter projhashes (POST)
orghash (POST)
labelids (POST)
titleprefix (POST)
title (POST)
function (POST)
birthday (POST)
costumernumber (POST)
description (POST)
email (POST)
email2 (POST)
phoneWork (POST)
phonePrivate (POST)
phoneMobile (POST)
fax (POST)
socialFacebook (POST)
socialTwitter (POST)
socialLinkedin (POST)
socialXing (POST)
format
Rückgabewerte  hash
Querschnittverbindungen getProjects() – Diese Funktion enthält die Projekt Hashes. getOrganisations()  – Diese Funktion enthält Organisation Hashes. getLabels() – Diese Funktion enthält labelids.
Hinweise Alle Parameter, die nicht in der Route enthalten sind, werden per POST versendet.

Parameter

Bezeichnung Beschreibung Wertebereich Standardwert
titleprefix Anrede in Brieftexten. (z.B. Sehr geehrter Herr) string
title Titel der Person. (z.B. Dr.) string
firstname Vorname der Person. string
lastname Nachname der Person. string
function Funktion der Person. string
birthday Geburtstag der Person. YYYY-MM-DD
costumernumber Kundennummer der Person. string
orghash Organisation Hash string
description Beschreibung des Kontaktes. string
labelids label ids array of strings
email Primäre E-Mail string
email2 Sekundäre E-Mail string
phoneWork Telefonnummer string
phonePrivate Telefonnummer – privat string
phoneMobile Telefonnummer – mobile string
fax Faxnummer string
socialFacebook Facebook-ID (aus facebook.com/*Facebook-ID*) string
socialTwitter Twitter-Benutzername (aus twitter.com/*Benutzername*) string
socialLinkedin LinkedIn-ID (aus linkedin.com/in/*Linkedin-ID*) string
socialXing Xing-Benutzername (z.B. xing.com/profile/*Benutzername*) string
projhashes Projekt Hashes array mit Projekthashes
format Legt fest in welchem Format das Ergebnis zurückgeliefert werden soll. json|xml json

Rückgabewerte

Bezeichnung Beschreibung Wertebereich
hash Id der Person (a-z0-9){32}

Meldungen

Nachricht Beschreibung
no permission Der Schlüssel hat keinen Zugriff auf diese Funktion.
internal error Ein interner Fehler ist aufgetreten.
param missing Ein erforderlicher Parameter wurde nicht übergeben.
param invalid Der Wert eines übergebenen Parameters ist nicht gültig.
result empty Die Bearbeitung der Anfrage war erfolgreich, aber das Ergebnis ist leer.
cost error Der aktuelle Kreditumfang reicht nicht aus, um die Anfrage zu bearbeiten.
0k. Die Bearbeitung der Anfrage war erfolgreich.

Beispielcode

$root = 'https://suite.xovi.net/api/';
$arrayParams = array(
    'service' => 'addressbook',
    'method'  => 'addPerson',
    'key'     => 'myPersonalKey',
);
$pathString = implode('/', $arrayParams);

$requestURL = $root.$pathString;

$arrayParams = array(
    'firstname' => 'MyContactFirstname',
    'lastname'  => 'MyContactLastname',
);
$paramsString = http_build_query($arrayParams);

if (!function_exists('curl_init')) die('cURL not available');

$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_URL, $requestURL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

//setup POST
curl_setopt($ch, CURLOPT_POST, count($arrayParams));
curl_setopt($ch, CURLOPT_POSTFIELDS, $paramsString);

// Download the given URL, and return output
$output = curl_exec($ch);

// Close the cURL resource, and free system resources
curl_close($ch);

echo $output;

Beispielergebnisse

JSON

{
    "apiErrorCode":0,
    "apiErrorMessage":"0k.",
    "apiResult":[
        {
            "hash":"b4b292d0c16f20eee10a7754539a189c"
        }
    ]
}

XML

<?xml version="1.0"?>
<result>
    <apiErrorCode>0</apiErrorCode>
    <apiErrorMessage>0k.</apiErrorMessage>
    <apiResult>
        <persons>
            <person>
                <hash>3957d580698c3345c9a962e077c44961</hash>
           </person>
        </persons>
    </apiResult>
</result>