This shows you the differences between two versions of the page.
— |
design2budget:webservice:modules:users [2015/11/27 14:09] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== design2budget Entwickler Webservice Dokumentation ====== | ||
+ | |||
+ | Zurück zur [[design2budget:webservice|Webservice Dokumentation Startseite]] | ||
+ | |||
+ | ====== Modul users ====== | ||
+ | |||
+ | Jedes Modul bietet einige Basis-Operationen. Siehe [[design2budget:webservice|Webservice Dokumentation Startseite]]. | ||
+ | |||
+ | ^ action ^ Beschreibung ^ | ||
+ | | login | User Login | | ||
+ | | logut | User Logout | | ||
+ | |||
+ | ====== users/login ====== | ||
+ | |||
+ | Einloggen mit Benutzername (=Email Adresse) und Passwort. | ||
+ | |||
+ | Im Erfolgsfall wird eine gültige Session ID zurückgeliefert. | ||
+ | Diese SID ist später für jeden weiteren Aufruf notwendig (siehe Beispiel logout) | ||
+ | |||
+ | ==== GET ==== | ||
+ | |||
+ | https://server/tenant/s/users/login/ | ||
+ | |||
+ | ==== POST ==== | ||
+ | |||
+ | ^ Parameter ^ Beschreibung ^ | ||
+ | | username | Benutzername (üblicherweise Email Adresse) | | ||
+ | | password | Passwort | | ||
+ | |||
+ | ==== RETURN ==== | ||
+ | |||
+ | Der Parameter sid beinhaltet die gültige Session ID, die für jede weitere Aktion benötigt wird. | ||
+ | |||
+ | Beispiel: | ||
+ | <code javascript> | ||
+ | {"module":"users","error":0,"loggedin":true,"sid":"9bd3b5f93692e4659632c8585eb35447","userinfo":{"id":"1","username":"admin@domain.tld","accesstype":"1024","status":"0","data":"b:0;","tenant":"0","lastname":"Tester","firstname":"Chuck","email":"admin@domain.tld","tel":"+436646285463","location_string":null,"location":"0","location_street":"","location_city":"","location_zip":"0","location_country":"","tenant_name":null,"logintime":1428168110,"ip":"127.0.1.1","token":"2938d72d41179950b9c8d3abd3076207","sid":"9bd3b5f93692e4659632c8585eb35447","lastupdate":1428168110,"validuntil":1428196910,"s_id":49235,"at_superadmin":false,"at_admin":true,"at_backoffice":false,"at_sales":false,"at_technician":false,"at_guest":false}} | ||
+ | </code> | ||
+ | |||
+ | ====== users/logout ====== | ||
+ | |||
+ | Ausloggen: Invalidieren einer Session ID. | ||
+ | |||
+ | ==== GET ==== | ||
+ | |||
+ | https://server/tenant/s/users/logout/?sid=sessionID | ||
+ | |||
+ | Beispiel: | ||
+ | |||
+ | https://server/tenant/s/users/logout/?sid=9bd3b5f93692e4659632c8585eb35447 | ||
+ | |||
+ | ==== POST ==== | ||
+ | |||
+ | keine | ||
+ | |||
+ | ==== RETURN ==== | ||
+ | |||
+ | Beispiel: | ||
+ | <code javascript> | ||
+ | {"module":"users","error":0} | ||
+ | </code> | ||