PHP
Um die Anbindung der API unter PHP zu vereinfachen, haben wir das PHP SDK entwickelt. Dieses SDK bietet die Möglichkeit, die API zu benutzen, ohne sich um HTTP-Kommunikation, Requestsignierung oder Responsesignaturüberprüfung kümmern zu müssen. Außerdem werden alle Responses als reine PHP-Objekte zur Weiterverarbeitung ausgeliefert. Das SDK bietet sowohl bei der reinen Backend-Backend Kommunikation Hilfe, als auch beim Parsen und Validieren der Loginantworten beim Login bzw. Kontaktimport mit vorausgegangener Authentifizierung.
Download und Dokumentation
Die aktuelle Fassung des SDK und des dazugehörigen PHPDoc finden Sie immer auf dieser Seite.
- SDK-Archiv (Bibliothek, abhängige Bibliotheken): sociallyve-php-sdk-0.5.2.0.zip
- Pfad zum PHPDoc: http://cdn.allyve.com/php-sdk/doc
Einbindung der Bibliotheken
Zum Einbinden der Bibliothek laden Sie bitte das aktuelle Archiv des SDK auf Ihren Rechner herunter. Im Archiv befindet sich alle Klassen, die vom SDK verwendet werden. Bitte binden Sie die Datei “config.php” aus dem SDK Root-Verzeichnis per “require_once” in Ihr Projekt ein.
Instanziierung der Klasse sowie Verwendung
Zur Instanziierung der Api-Klasse werden die Zugangsdaten des Kunden benötigt. Hierzu gibt es die Klasse Credentials:
$creds = new Credentials($sociallyveAppId, $sociallyveAppSecret);
Diese Credentials werden dem Konstruktor übergeben:
$api = new SociallyveApi($creds);
Nun kann die Api direkt angesprochen werden, die Klasse SociallyveApi bietet alle Methoden der API an. Details zu den einzelnen Methoden entnehmen Sie dem PHPDoc.
$userInfo = $api->getUserInfo($externalUserId);
Überprüfung der Logindaten
Sehr wichtig ist die backendseitige Überprüfung der Logindaten, die die Javascriptbibliothek an das Frontend der Anwendung liefert. Das SDK bietet hierzu eine Methode, um den Querystring, wie er dem Frontend übergeben wird, zu validieren und in ein PHP-Objekt zu parsen:
$creds = new Credentials($sociallyveAppId, $sociallyveAppSecret);
$sApi = new SociallyveApi($creds);
try {
$loginData = $sApi->parseLoginData($loginQueryString);
} catch (SociallyveException $e) {
// Do some errorhandling
}
Nun steht ein LoginData Objekt zur Verfügung, welches alle Felder aus dem Querystring beinhaltet.
Weiterführende Information
Zur Übersicht über die serverseitigen SDKs der API.
Zuletzt aktualisiert am 8. Mai 2012 von admin - Anmelden
