DCP-API

Version vom 5. November 2019, 08:47 Uhr von TIm Niklas (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)


DCP-Api allgemein

Mit unseren Web-APIs (Application Programming Interface) bieten wir Ihnen die Möglichkeit, Funktionen im DCP mit Ihren eigenen Skripten zu automatisieren. Um unsere APIs nutzen zu können, vergeben Sie im DCP unter 'Passwörter' für Ihren API-Benutzer ein neues Passwort und setzen den Nutzer auf aktiv. Mit dem API-Benutzer und dem vergebenen Passwort können Sie sich dann ins DCP einloggen, um eine Übersicht der vorhandenen APIs zu bekommen:

Übersicht der angebotenen Funktionen

Api übersicht.png

database

   Hier finden Sie Scripte zum Anlegen neuer Datenbanken sowie zum Anzeigen und Löschen bestehender Datenbanken.

dcpuser

   Wir bieten Ihnen hier ein Script zum Anzeigen der DCP-User an.

dns

   Derzeit stehen keine Scripte für diesen Bereich zur Verfügung.

domain

   Derzeit steht ein Script zur Verfügung, das alle in Ihrem Webhosting Account befindlichen Domains mit Abrechnungsdatum anzeigt, sowie, falls vorhanden, ihre Zuordnung zu Ihrem DCP-User zu.

info

   Es ist ein Script vorhanden, um Accountdaten, wie vorhandener und verbrauchter Webspace, auszugeben.

mail

   Alles, was mit Mailfunktionen zu tun hat, finden Sie hier. Derzeit können Sie Passwörter für einen Mailaccount prüfen und ändern sowie die angelegten Mailaccounts anzeigen lassen.

stats

   In diesem Bereich finden Sie Scripte um Statistiken aus dem DCP abzurufen.

web

   In diesem Bereich finden Sie Scripte, um eine Subdomain anzulegen, zu löschen und zum Anzeigen der vorhandenen Subdomains sowie zur Bearbeitung Ihrer FTP-User.

Beispiel aus der Kategorie Web

Support2 dcp api beispiel.png In diesem Fall wird die Subdomain 'neu.domain.de' als lokale Domain mit dem Homeverzeichnis 'domain.de/www' angelegt. Dazu werden folgende Parameter benötigt:

  • fqdn=neu.domain.de - vollständiger Name der neuen Subdomain
  • type=local - Typ der neuen Subdomain
  • local_dir=domain.de/www - Homeverzeichnis der neuen Subdomain

Angenommen diese Informationen werden über ein HTML-Formular per POST an ein PHP-Skript übergeben, könnte der PHP-Code folgendermaßen aussehen:

   <?php
   $fqdn=$_POST['fqdn'];
   $type=$_POST['type'];
   $local_dir=$_POST['local_dir'];
   $url="https://api1234:passwd@dcp20.c.artfiles.de/api/web/
   add_subdomain.html?fqdn=$fqdn&type=$typel&local_dir=$local_dir"
   $result = file_get_contents($url);
   echo $result;
   ?>

Als Ergebnis wird "OK" zurückgegeben, wenn die Subdomain erfolgreich angelegt wurde. Ansonsten wird als Ergebnis "ERROR" zurückgegeben.

Auf gleiche Weise können unter anderem Subdomains, Mailaccounts, Datenbanken erstellt, geändert oder gelöscht werden. Eine Übersicht der verwendeten Parameter und Ausgaben der APIs finden Sie im DCP. Bitte beachten Sie, dass die DCP-API nur per HTTPS erreichbar ist.

Weitere Beispiele zur Verwendung

       Anlegen einer neuen Datenbank:
       https://api1234:passwd@dcp20.c.artfiles.de/api/database/add_database.html?type=mysql&pass=dbpasswd
       Liste aller DCP-User ausgeben:
       https://api1234:passwd@dcp20.c.artfiles.de/api/dcpuser/get_dcpuser.html
       Liste aller Domains eines DCP-Users ausgeben:
       https://api1234:passwd@dcp20.c.artfiles.de/api/domain/get_domains.html?dcpuser=dcp12340001
       Ändern eines Passwortes für einen Mailaccount:
       https://api1234:passwd@dcp20.c.artfiles.de/api/mail/set_password.html?account=mail@domain.de&password=passwd