REST API für Kontakte

hansa 2021-12-14 13:48:37 UTC #1

Ganz herzlichen Dank für die REST API! Das ist wirklich eine Funktion die ganz oben auf dem Wunschzettel stand.

Ich würde die Funktion gerne aus PHP heraus nutzen, scheitere aber leider trotz der Doku.

Um einen neuen Kontakt anzulegen habe ich den dokumentierten (und funktionierenden) CURL Aufruf

cat <<EOF | curl -i 'https://example.org/egroupware/groupdav.php/<username>/addressbook/' -X POST -d @- -H "Content-Type: application/json" --user <username>
{
  "fullName": "First Tester",
  "name/personal": "First",
  "name/surname":  "Tester",
  "organizations/org/name": "Test Organization",
  "emails/work": "test.user@test-user.org",
  "addresses/work/locality": "Test-Town",
  "addresses/work/postcode": "12345",
  "addresses/work/street": "Teststr. 123",
  "addresses/work/country": "Germany",
  "addresses/work/countryCode": "DE",
  "phones/tel_work": "+49 123 4567890",
  "online/url": "https://www.example.org/",
  "notes/note": "This is a note.",
  "egroupware.org:customfields/Test": "Content for Test"
}
EOF

versucht in php zu transferieren.

require_once __DIR__ .'/vendor/autoload.php';

use Ramsey\Uuid\Uuid;

$uuid = Uuid::uuid4();

// set post fields
$post = [
	"uid"  => "urn:uuid:" . $uuid,
	'fullName' => "First Tester3",
	'name/personal' => "First",
	"name/surname" =>  "Tester",
	"organizations/org/name" => "Test Organization",
	"emails/work" => "test.user@test-user.org",
	"addresses/work/locality" => "Test-Town",
	"addresses/work/postcode" => "12345",
	"addresses/work/street" => "Teststr. 123",
	"addresses/work/country" => "Germany",
	"addresses/work/countryCode" => "DE",
	"phones/tel_work" => "+49 123 4567890",
	"online/url" => "https://www.example.org/",
	"notes/note" => "This is a note.",
	"egroupware.org:customfields/Test" => "Content for Test"
	];

$post = json_encode($post);

$ch = curl_init('https://egw.xxxxx.de/egroupware/groupdav.php/hansa/addressbook/');
curl_setopt($ch, CURLOPT_USERPWD, "xxx:yyyy");
curl_setopt($ch, CURLOPT_HTTPHEADER, Array("Content-Type:Content-Type: application/json", "Accept: application/pretty+json"));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);

// execute!
$response = curl_exec($ch);

// close the connection, release resources used
curl_close($ch);

// do anything you want with your response
var_dump($response);

Das funktioniert soweit (Adressbucheintrag wird angelegt), gibt aber keine Rückmeldung über den angelegten Kontakt. Nach der Doku würde ich eine ‘Location’ erwarten.
Es kommt : string(0) “” zurück.

Zudem verstehe ich nicht, warum ich die uuid mitgeben muss. Ohne diese bekomme ich

string(113) "{
    "error": 422,
    "message": "Error parsing JsContact Card attribute 'uid': Invalid or missing UID: null"
}"

Wenn ich den Aufruf via curl in der shell mache, geht es ohne uid und ich bekomme auch die ‘Location’ zurück.

Zudem habe ich versucht mittels
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
den angelegten Kontakt wieder zu löschen. Das ging leider auch nicht.
Was mache ich falsch?

Dank und Gruß
Hansa

RalfBecker 2021-12-15 18:24:44 UTC #2

Der Content-Type ist doppelt, deswegen brauchst du UUID.

Die Location is ein Header der zurück kommt, sprich Du musst Dir von curl nicht den Body sondern die Header geben lassen.

Ralf

hansa 2021-12-16 08:17:14 UTC #3

Dankeschön!!!

Jetzt läuft es. Ich paste mal, wie ich es jetzt habe. Vielleicht braucht es noch jemand.

$post = [
‘fullName’ => “First Tester”,
‘name/personal’ => “First”,
“name/surname” => “Tester”,
“organizations/org/name” => “Test Organization”,
“emails/work” => "test.user@test-user.org",
“addresses/work/locality” => “Test-Town”,
“addresses/work/postcode” => “12345”,
“addresses/work/street” => “Teststr. 123”,
“addresses/work/country” => “Germany”,
“addresses/work/countryCode” => “DE”,
“phones/tel_work” => “+49 123 4567890”,
“online/url” => “https://www.example.org/”,
“notes/note” => “This is a note.”,
“egroupware.org:customfields/Test” => “Content for Test”
];

$ch = curl_init(‘https://egw.xxxx.de/egroupware/groupdav.php/hansa/addressbook/’);
curl_setopt($ch, CURLOPT_USERPWD, “xxx:yyyy”);
curl_setopt($ch, CURLOPT_HTTPHEADER, Array(“Content-Type: application/json”, “Accept: application/pretty+json”));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ‘POST’);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post));
curl_setopt($ch, CURLOPT_HEADERFUNCTION,
function($ch, $header) use (&$headers)
{
$len = strlen($header);
$header = explode(’:’, $header, 2);
if (count($header) < 2) // ignore invalid headers
return $len;

$headers[strtolower(trim($header[0]))][] = trim($header[1]);

return $len;

}
); //Funktion um über die einzelnen Zeilen des Headers zu iterieren und ein Array zu erzeugen

$response = curl_exec($ch); // execute!
#print_r($headers); // headers als multi Array $headers[‘location’][0] ist die angelegte Kontakt ID in der EGW
$egw_contact_id = trim (str_replace("/egroupware/groupdav.php/hansa/addressbook/", “”, $headers[‘location’][0]));
echo $egw_contact_id;

// close the connection, release resources used
curl_close($ch);

Gruß,
Hansa

hansa 2021-12-16 08:19:09 UTC #4

und der delete geht so:

//// delete contact ///////////
$ch = curl_init(‘https://egw.xxxx.de/egroupware/groupdav.php/hansa/addressbook/’ . $id_todelete);
curl_setopt($ch, CURLOPT_USERPWD, “xxx:yyy”);
curl_setopt($ch, CURLOPT_HTTPHEADER, Array(“Content-Type: application/json”, “Accept: application/pretty+json”));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, ‘DELETE’);

// execute!
$response = curl_exec($ch);

// close the connection, release resources used
curl_close($ch);