Schnittstelle
Alle von adorius angebotenen Funktionen können mittels unserer Schnittstelle aus der Ferne angesprochen werden. Selbstverständlich kommen mit der Nutzung unserer Schnittstelle keine Mehrkosten als Kunde auf Sie zu. Dieses Beispiel verdeutlicht den Aufruf der Schnittstelle über das XML-RPC-Protokoll, wobei hier ein Brief versendet werden soll. Bei der XML-RPC-Schnittstelle benötigen Sie eine bestimmte PHP-Datei (request.class.php), welche Sie als adorius-Kunde downloaden können.
Beispielaufruf in PHP (Funktion postalService zum Postversand)
<?php
/**
*
* @package Example
*
*/
include('./classes/request.class.php');
/**
Zugangsdaten des adorius-Kunden
Das Passwort für die Schnittstelle unterscheidet sich
aus Sicherheitsgründen vom Passwort des Kundenbereichs.
*/
$username = 'Benutzername';
$password = 'Passwort';
/**
Befehl, der ausgeführt werden soll
In diesem Falle "postalService", also der postalische
Briefversand durch adorius.
*/
$method = 'postalService';
/**
Parameter
Zielland, Druckmodus, Druckvariante und der Link zu dem
PDF-Dokument, welches versendet werden soll.
*/
$params['country'] = 'DE';
$params['printMode'] = 'simplex';
$params['printVariant'] = 'color';
$params['file'] = 'https://www.adorius.de/downloads/beispielPDF.pdf';
/**
Vorbereiten
*/
$request = new request($username, $password, NULL);
/**
Befehl ausführen
*/
$result = $request->call($method, $params);
/**
Rückgabewert leserlich ausgeben
*/
print('<pre>');
print_r($result);
print('</pre>');
?>Rückgabe
Im Erfolgsfall sollten Sie folgendes Array vom adorius-Server zurückerhalten.
Array
(
[adoCode] => 100
[adoMsg] => Der Brief wurde erfolgreich in den Versand gegeben.
)