Java
Um die Anbindung der API unter Java zu vereinfachen, haben wir das Java 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 Java-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 JavaDoc finden Sie immer auf dieser Seite.
- SDK-Archiv (Bibliothek, abhängige Bibliotheken): sociallyve-java-sdk-0.5.2.0.zip
- Pfad zum JavaDoc: http://cdn.allyve.com/java-sdk/javadoc
Einbindung der Bibliotheken
Zum Einbinden der Bibliothek laden Sie bitte das aktuelle Archiv des SDK auf Ihren Rechner herunter. Im Archiv befindet sich die eigentliche Bibliothek nach dem Namensschema “sociallyve-sdk-<Versionsnummer>.jar” sowie ein Verzeichnis “dependencies” mit weiteren Bibliotheken, die vom SDK verwendet werden.
Instanziierung der Klasse sowie Verwendung
Zur Instanziierung der Api-Klasse werden die Zugangsdaten des Kunden benötigt. Hierzu gibt es die Klasse Credentials:
Credentials creds = new Credentials(sociallyveAppId, sociallyveAppSecret);
Diese Credentials werden dem Konstruktor übergeben:
SociallyveApi 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 JavaDoc.
UserInfo 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 Javaobjekt zu parsen:
Credentials creds = new Credentials(sociallyveAppId, sociallyveAppSecret);
SociallyveApi sApi = new SociallyveApi(creds);
LoginData loginData = null;
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 Sociallyve-API
Zuletzt aktualisiert am 8. Mai 2012 von admin - Anmelden
