Web Service API - Registration and Access Management

The Request<T> class has a "Ticket" property. This is used to pass the authentication to the web service.

To get a new ticket, the Login Method is called. The user name and password are passed to this method. If the login to c-entron was successful, a ticket (a randomly generated character string) is returned. This character string tells the c-entron web service which user is involved.

https://server.de/CentronService/REST/Login { "Ticket": "", "TrimResponse": 0, "Data": { "AppVersion": "1.0.0.0", "Application": "{8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22}", "Device": "OfficeClient1", "LoginKind": 0, "Password": "Pa$$word!", "Username": "CentronUser" }}

Methods for registration/access management

Method	Description
Login	This is the most important method in the web service. Users log in to the web service using this method. If the registration is successful, you will receive a ticket, which you must specify in the Request object for all methods from now on. Request: Username c-entron login name Password: User password LoginChild : Specifies the type of login. 0 = c-entron user 1 = Mandatory login via AD. (Not usually necessary. If AD login has been enabled in the settings, all logins with ID 0 are automatically set to 1 on the web service page. 2 = Customer access (web account) Application : Specify the following GUID here: {8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22} AddVersion : Here you can transfer the version of your application (optional) Device : Here you can transfer the device used to log in (optional)
Logout	This method allows you to log a user out of the web service (via the ticket).
IsValidTicket	This method checks whether the ticket is still valid.
CheckConnection	This method simply returns the value True. This can be used to check whether a connection to the web service can be established. This method does not require a ticket.
IsWebAccountAuthentication	This method allows you to check whether the ticket is a "web account" (customer access).
GetAllConnectionTickets	You can use this method to read all logged-in users.
RemoveConnectionTicket	You can use this method to log users out of the web service.
GetWebServiceSettings	This method returns special web service-related settings.
SetWebServiceSettings	This method saves the special web service-related settings.
GetCommonLoginInformation	This method returns general information about the logged-in user, including their rights in the system.
IsUserAdmin	Indicates whether the logged-in user is an administrator.