Das mgw-media.de API (Application Programming Interface)

Domain-Aktionen können Sie nicht nur auf manuellem Wege über die komfortable Verwaltungsoberfläche unseres Domain Robot Interfaces erledigen, sondern auch über eine vordefinierte Schnittstelle. Für all diejenigen, die Wert auf einen gewissen Automatisierungsgrad legen, haben wir eine komfortable Schnittstelle geschaffen. Unser XML SOAP-API.

Mit unserer SOAP XML/PHP Schnittstelle bieten wir Ihnen die Möglichkeit Ihre Geschäftsprozesse zur Bestellung und Verwaltung von Domains hochgradig automatisierbar zu machen. Das mgw-media.de API ermöglicht über vordefinierte Funktionen eine sehr effektive und flexible Automatisierung der Domain-Aktionen.

Jeder unserer Kunden entscheidet individuell für sich, ob er lieber unser Domain Robot Interface, die SOAP Schnittstelle oder beide Möglichkeiten parallel einsetzen möchte. Das API ermöglicht versierten Teilnehmern die direkte Verkopplung der eigenen Geschäftsprozesse mit dem mgw-media.de Domain-Service.

Nachfolgend wollen wir Ihnen das API genauer erläutern. Sollten dennoch Fragen offen bleiben oder sich Unstimmigkeiten ergeben, so steht Ihnen unser Technik-Team jederzeit mit Rat und Tat zur Seite.

SOAP basiert auf XML, ist aber ganz einfach. Im Prinzip werden einfach Funktionen auf einem entfernten System ausgeführt (in diesem Fall auf unserem Server). Hierzu bedient sich die Client-Seite einer sogenanntem SOAP-Nachricht, die in etwa wie folgt aussieht:

<?xml version="1.0" encoding="ISO-8859-1"?>
     <SOAP-ENV:Envelope
          SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
          xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
     <SOAP-ENV:Body>
          <ns4718:CheckDomain xmlns:ns4718="http://tempuri.org">
               <user xsi:type="xsd:int">1234</user>
               <hash xsi:type="xsd:string">e2be4e9ff9bc7aede653a57e0bfcb1c2</hash>
               <domain xsi:type="xsd:string">mgw-media.de</domain>
          </ns4718:CheckDomain>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Die auf diese Anfrage folgende Antwort unseres Servers sieht in etwa so aus:

<?xml version="1.0" encoding="ISO-8859-1"?>
     <SOAP-ENV:Envelope
          SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
          xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
     <SOAP-ENV:Body>
          <ns1:CheckDomainResponse xmlns:ns1="http://tempuri.org">
               <return>
                    <ret_code xsi:type="xsd:int">211</ret_code>
                    <ret_title xsi:type="xsd:string">Domainname nicht verfügbar</ret_title>
                    <ret_message xsi:type="xsd:string">Der gewählte Domainname ist nicht verfügbar.</ret_message>
               </return>
          </ns1:CheckDomainResponse>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Das Ganze sieht wahrscheinlich komplizierter aus, als es tatsächlich ist, denn die schwierigen Dinge wie z.B. Nachrichtenerstellung und Übermittlung sowie das parsen der Rückantwort übernimmt das PHP-Framework für Sie. Das Resultat als Array ausgegeben sieht wie folgt aus:

Array
(
    [ret_code] => 211
    [ret_title] => Domainname nicht verfügbar
    [ret_message] => Der gewählte Domainname ist nicht verfügbar.
)

Durch eine ausführlich dokumentierte Beispieldatei ist die Einbindung des API in das eigene System ein Kinderspiel. Demnach sollte jeder auch nicht so erfahrene Web-Entwickler in der Lage sein, das mgw-media.de API einzubinden. Sollte es doch einmal zu Problemen kommen, steht Ihnen unser Technik-Team jederzeit mit Rat und Tat zur Seite.

Die komplette PHP-Klasse zur Ansteuerung des API erhalten Sie in unserem Kundenbereich.