Damit der vereinfachte Zugriff möglich ist, ist die AWStats-SOAP-API unter folgender URL für alle Kunden erreichbar:

https://kunden.aditsystems.de/api/awstats/awstats.php

Eine kurze Dokumentation sowie das aktualisierte Joomla-Modul finden Sie im Wiki.

Diese SOAP-API ist unter folgender URL erreichbar:

https://monitoring.aditsystems.de/api/zabbix.php

Sehr angenehm war bei der Erstellung die Services_Webservice-Klasse von PEAR, welche das gesamte Handling der SOAP-Anfragen übernimmt. Die Erstellung der SOAP-API beschränkt sich damit auf das Schreiben der effektiven Funktionen.

Wer Probleme haben sollte, die Daten via SOAP abzurufen, dem sei die SoapClient-Klasse von PHP empfohlen. Andere Programmiersprachen bieten ebenfalls ähnliche Konzepte, um SOAP-Requests auszuführen.

Derzeit entsteht eine neue API, mit den gleichen Funktionen, aber jetzt basierend auf SOAP. Der SOAP-Server ist weiterhin in PHP geschrieben, jedoch lassen sich Clients auch jederzeit in anderen Sprachen erstellen – SOAP-Bibliotheken gibt es für fast alle derzeit im Web verwendeten Sprachen bzw. Frameworks.

Für PHP gibt es den SOAP-Client direkt als Extension in PHP. Durch die Kapselung lassen sich SOAP-Calls verarbeiten wie lokale Funktionen – Variablen-Übergaben an den Server erfolgen direkt aus PHP, die Server-Antwort wird direkt verarbeitet und an den PHP-Code zurückgegeben, wodurch sich auch kompliziertere Datentypen wie Arrays leicht verarbeiten lassen.

Effektiv ist der Code so klein, dass lediglich an den Klassen-/Variablen-Namen noch ersichtlich ist, dass ein SOAP-Aufruf stattfindet.

So macht Programmierung und die Einbindung der API in die internen Verwaltungs-Systeme Spass

Im Gegensatz zu Google Analytics u.ä. Anbietern fehlen jedoch noch Informationen, wie Bildschirmauflösung des Clients, Unterstützung von Plugins, …

Diesen Umstand kann AWStats auch ausgleichen: Durch das Einbinden einer speziellen Javascript-Datei sind diese Informationen dann auch in den Logfiles verfügbar, und werden von AWStats graphisch aufbereitet angeboten.

Wenn Sie auf diese erweiterten Statistiken zurückgreifen möchten, muss folgende Zeile in den Header der Webseite eingebunden werden:

Dies veranlasst AWStats, die erweiterten Informationen am Client auszulesen und zu analysieren.

Ab sofort können darüber auch die Länder der Besucher abgefragt werden, inkl. Ländercode sowie Prozentsatz der Seiten, die aus diesem Land aufgerufen wurden.

Für Joomla-Nutzer gibt es dafür auch ein entsprechendes Modul, welches, wie üblich, im Wiki zum Download bereit steht.

Beim DNS-Hosting erhalten Sie Zugriff auf unsere Nameserver über ein Webinterface sowie über eine XML-API. Sie können über beide Möglichkeiten alle DNS-Record-Typen verwenden, insbesondere die allgemein üblichen Typen wie A, MX, CNAME, NS oder via Webinterface die SOA-Einträge.

Durch die Verwendung von PowerDNS mit direkter MySQL-Anbindung als Nameserver-Software sind Änderungen an den Zonen binnen kürzester Zeit (<120s) auf allen Nameservern publiziert – Sie brauchen nicht erst mehrere Stunden auf einen Reload der Nameserver warten, die neuen Einträge sind sofort verfügbar!

Des weiteren sind die Nameserver durch unterschiedliche Anbindungen und Rechenzentren gegen Ausfälle geschützt – ns1/ns2 in Nürnberg sowie ns3 in München sorgen für ausfallsichere DNS-Dienstleistung.

Ab DNS-250 bieten wir Ihnen an, nicht nur die von uns vorgegebenen Reseller-neutralen DNS-Server ns1/ns2/ns3.as-dns.de zu nutzen, sondern auch ein Set von Nameservern unterhalb einer beliebigen Domain von Ihnen einzurichten.

In allen Tarifen steht Ihnen des weiteren ein Domain-Robot (DNS-50 und DNS-100 nur gegen Aufpreis) zur Verfügung, über den Sie günstig mehr als 70 Toplevel-Domains registrieren können – die populärsten TLDs sogar in Echtzeit! Domain-Preise erhalten Sie auf Anfrage bei unserem Support.

Weitere Informationen finden Sie im Wiki unter folgender URL:

http://wiki.aditsystems.de/webseite/confixx-api/customer/gettrafficextended

Da sich durch die Verwendung einer DOM-Klasse aus PHP5 jedoch die XML-Struktur etwas geändert hat, ist die API unter einer anderen URL verfügbar, bis die bisherigen Schnittstellen upgedatet wurden.

Neu verfügbar sind nun nicht nur die Statistiken je Tag, sondern auch alle Referrer des Monats sowie die Suchbegriffe aus den Suchmaschinen, mit denen ein Besucher auf Ihre Webseite kam.

Die neuen (übergangsweisen) URLs lauten:

• https://stats.web.aditsystems.de/api_new.php
• https://stats.mars.aditsystems.de/api_new.php

Weitere Informationen finden Sie hier.

Nachdem uns ein Kunde angesprochen hat, ob die Statistiken nicht auch anderweitig abrufbar wären, haben wir eine entsprechende XML-API geschrieben.

Diese API ist insbesondere zum Einbau in Live-Webseiten geeignet, da die Besucher des Tages, Monats, Jahres sowie Traffic, Unique-Hits, Seiten etc direkt eingebunden werden können.

Für Benutzer von Joomla haben wir noch ein Modul geschrieben, um so direkt auf der Webseite die Statistiken anzeigen zu können.

Die aufgerufen Statistiken werden für verbesserte Laufzeiten zwischengespeichert und nur stündlich neu ausgelesen. Die Statistiken selbst werden alle 2 Stunden neu ausgewertet.

Technisches

Um die Statistiken aufzurufen, benutzen Sie am besten CURL. Die URL der API lautet wie folgt:

• https://stats.web.aditsystems.de/api.php (Venus)
• https://stats.mars.aditsystems.de/api.php (Mars)

Folgende erforderliche Parameter müssen Sie über POST übermitteln:

• “username”
• “password”

Mit diesen Angaben können Sie die Statistiken Ihres Usernamens abrufen.

Um zusätzlich noch Statistiken für einzelne Domains abzurufen, übergeben Sie den optionalen Parameter “stats” mit dem Namen der (Sub-)Domain.

Den Download des Joomla-Moduls finden Sie hier.

Geben Sie nach der Installation in der Konfiguration des Moduls noch folgendes als “HTML-Template” an:

<div class="mod_awstats"><br />
<table width="100%" cellspacing="0" cellpadding="0" border="0">
	<tr>

		<td colspan="2">Stündliche Aktuallisierung!</td>
	</tr>
	<tr>
		<td></td>

		<td></td>
	</tr>
	<tr>
		<td>Besucher heute:</td>
		<td>{visits_today}</td>

	</tr>
	<tr>
		<td>Maximum pro Tag:</td>
		<td>{peak_visits}</td>
	</tr>

	<tr>
		<td>Besucher diesen Monat:</td>
		<td>{visits}</td>
	</tr>
	<tr>

		<td>Besucher gesamt:</td>
		<td>{overall_visits}</td>
	</tr>
</table>
</div>

Bei Anfragen steht Ihnen unser Support per eMail zur Verfügung.

Derzeit ist es nur möglich, den verbrauchten Speicherplatz sowie den Datentransfer (beides detailliert aufgeschlüsselt) abzurufen.

Verwenden Sie am besten CURL, um auf die URL http://api.a1a.biz/confixx.php zuzugreifen.

Ein Beispiel-Request zum Abruf des Speicherplatzes sieht so aus:

Um den Datentransfer zu erhalten, verwenden Sie als Action bitte “gettraffic”.

Da dieser Request von Curl nicht interpretiert werden kann, nutzen Sie am besten folgende Funktion, um den Request als POST-Feld bei CURL benutzen zu können:

Der Funktion wird in $data ein passender Request übergeben, als Rückgabewert erhalten Sie einen String, den CURL weiterverarbeiten kann.

Als Rückgabe erhalten Sie von unserer Confixx-API einen String, der XML-Daten erhält und am besten mit SimpleXML weiterverarbeitet werden kann.

Ein Beispiel dieser Rückgabe folgt:

So können Sie sich Skripte schreiben, welche z.B. regelmäßig den verbrauchten Speicherplatz überprüfen und dann Uploads verweigern, wenn der Speicherplatz nicht mehr reichen würde.

Außerdem ist es möglich, den Datentransfer auszulesen.

Funktionsübersicht (abgeschlossen):

• Speicherplatz-Auswertung
• Datentransfer

Funktionsübersicht (geplant):

• Anlegen von neuen Postfächern, Subdomains, eMail-Adressen
• Ändern von Passwörtern
• Löschen von Postfächern, Subdomains, eMail-Adressen

Wenn die geplanten Funktionen vollständig umgesetzt sind, wird es eine entsprechende Dokumentation zur Nutzung sowie den vorhandenen Funktionen geben.
Bei Fragen wenden Sie sich an den Support.

Derzeit werden folgende Funktionen unterstützt:

• Auflistung aller Zonen
• Auflistung einer Zone
• Auflistung der Templates
• Erstellen einer Zone mit Hilfe eines Templates
• Löschen einer Zone
• Auflistung von DNS-Einträgen einer Zone
• Erstellen einer leeren Zone ohne Template
• Einfügen von DNS-Records

Folgende Funktionen werden derzeit noch entwickelt:

• Löschen von DNS-Records
• Ändern von DNS-Records

Die API wird auch benutzt, um mit dem geplanten Domain-Roboter im KundenCenter Domains zu erstellen, wenn ein Kunde diese registrieren lassen will.
Für Fragen zur Einbindung steht unser Support wie immer zur Verfügung.

Diese Applikation wurde nun auch auf zusätzliche FTP-Accounts erweitert, wodurch eine neue URL nötig wurde.

Sie können die Passwörter für zusätzliche FTP-Accounts sowie für Postfächer zentral unter folgender URL ändern, egal, auf welchem Server Sie sich befinden:

https://passwort.aditsystems.de/

Dieses Interface ist lediglich provisorisch und wird beim Relaunch der Webseite in das Design mit eingegliedert.

Sie finden die Seite unter folgender Adresse:

http://postfach.aditsystems.de

Bitte teilen Sie Probleme beim Ändern des Passwortes unserem Support per Mail an support@aditsystems.de mit.