Liebe Beta-Tester unserer API,
wir haben ihr Feedback ernst genommen und werden daher die API innerhalb der beta-Testphase anpassen.
Die wesentliche Anpassung wird sein, dass Eingabe und Ausgabe bei SOAP jetzt als Objekt statt als Array erfolgen wird. Die dafür notwendigen Objekte sind in der WSDL beschrieben und im Beispiel Soap Client in PHP implementiert. Die Anpassungen auf Kundenseite sind überschaubar und bringen für Sie den entscheidenden Vorteil, dass auf Client Seite gleich mit Objekten weiter gearbeitet werden kann.
Nach dem Release erfolgt bei solchen nicht abwärtskompatiblen Änderungen eine Versionierung, die mindestens für eine Übergangsphase den parallelen Betrieb ermöglicht.
Es gibt jetzt ein einheitliches Response Objekt mit Infos wie
- Meldungsnummer
- kurze/lange Rückmeldung
- Client Request Id
- Server Request Id, etc.
Zudem enthält der Response je nach Befehl die passenden Objekte jetzt einheitlich im Feld responsedata z.B.
- Domainobjekt bei infoDomain
- Handleobjekt bei infoHandlec.
Im Feld Longmessage ist dann immer ausschließlich ein Rückmeldungstext zu finden.
Sind mehr als ein Objekt in der Rückmeldung z.B. bei Poll oder listallDomains, sind die Objekte in einem Array im Feld responsedata zu finden.
Bei Aktionen wie deleteHandle, ackpoll, logout, etc. wird kein Response Objekt benötigt. Informationen im einheitlichen Response Objekt über Erfolg oder Misserfolg reichen.
Errors wie gehabt als SOAP Fault Objekte.
Alle Objekte sind in der WSDL/XSD beschrieben.
Für die Inbetriebnahme geben wir hiermit Wartungsarbeiten bekannt, während deren die API nicht erreichbar sein wird.
Mittwoch, 03.01.2018, ab 10 Uhr
Wir halten Sie hier über den Verlauf des Updates auf dem Laufenden.
Anbei finden Sie die Dateien, wie sie nach dem Update aussehen werden.
Beispiele in PHP*
* ohne Gewähr.
Anpassung Login
SOAP:
$client = new DomainWebserviceSoapClient();
$resultlogin = $client->login($customernumber, $apikey, $apipassword, $clientrequestid);
$apisessionid = $resultlogin->responsedata->apisessionid;
Bei Rest sind für das Login keine Anpassungen notwendig.
Anpassung Domain Jobs
Die Nameserver und Kontakt Einträge sind in Zukunft als Objekt zu Übergeben.
SOAP und REST:
$assignedhandletypes_obj = new Contactentries();
$assignedhandletypes_obj->ownerc = 123;
$assignedhandletypes_obj->adminc = 456;
$assignedhandletypes_obj->techc = 789;
$assignedhandletypes_obj->zonec = 741;
$assignedhandletypes_obj->billingc = 852;
$assignedhandletypes_obj->onsitec = 963;
$contacts = $assignedhandletypes_obj;
$nameservers = new Nameserverentries();
$nameserverentry1 = new Nameserverentry();
$nameserverentry1->hostname = "ns1.nameserverdomain.de";
$nameserverentry1->ipv4 = "12.34.56.78";
$nameserverentry1->ipv6n= "123:0000:4:5600::8";
$nameservers->nameserver1 = $nameserverentry1;
$nameserverentry2 = new Nameserverentry();
$nameserverentry2->hostname = "ns2.nameserverdomain.de";
$nameserverentry2->ipv4 = "12.34.56.178";
$nameserverentry2->ipv6 = "123:0000:4:5600::7";
$nameservers->nameserver2 = $nameserverentry2;
$assignedhandletypes_obj = new Contactentries();
$assignedhandletypes_obj->ownerc = 111;
$assignedhandletypes_obj->adminc = 222;
Alles anzeigen
Ihre Fragen zur Anpassung sind hier stets Willkommen.