This is the documentation for the 24SevenOffice API. Here you will find an overview of our current APIs. There are some examples to help you get started with our most commonly used APIs, while other descriptions are more bare bones they should be largely self explanatory. Please note that most integrations will require some familiarity with the inner workings of the 24SevenOffice system and that you should have some business rules and use cases in place before proceeding with an integration. We have an extensive Help Center that will provide many answers and good insights.
If you have not already done so, please create a community user. This is the username and password you will use to authenticate towards the web services.
Once you have a community user, you need to register as an API partner (sign up form only in Norwegian). Once you’ve registered you will receive credentials for a demo client. Finally you need to request an ApplicationId..
Remember that these are two separate steps and that you have to follow the instructions below to get your applicationId.
Request an ApplicationID
Every integration needs an ApplicationId. This is a “per integration” key and not a “per customer” key. Please note that the ApplicationId has no association to any specific clients in the 24SevenOffice system and is not used a direct form of authentication for any specific client. This is handled through the IdentityId in the Login method and/or the use of the GetIdentity and SetIdentity methods in the Authenticate service. To request an ApplicationID, please send an email to firstname.lastname@example.org with the following information:
- Name of integration/application
- Email address of contact person/developer. (This Email MUST be a registered community account in our system: Register)
Get up and running with authentication
To get started using our webservices, please follow these steps:
- Initialize a SoapClient/WebService-object to Authenticate
- Check if there is an ASP.NET_SessionId saved (see step 4), if yes, go to step 5
- Log in using the Login method. The Login method uses a Credential object as parameter, which requires username, password and ApplicationID. The username is always an email address (community user).
- Save the ASP.NET_SessionId that is returned from the Login method (Save it on your side using Database/Cookies/Session/Etc)
- Check if ASP.NET_SessionId is still alive at 24SevenOffice by using AuthenticateService’s HasSession method. If it does not, go to step 3.
- Initialize a SoapClient/WebService-object to the Webservice that you want to use
- Set the cookie with the name “ASP.NET_SessionId” to the SessionId-value you confirmed in step 5, and pass this cookie along to the webservice that you’re going to use.
You need to add Web References your project by following this simple guide : Add Web Reference
If you have any questions, please do not hesitate to contact us on email@example.com
Please read the terms for 24SevenOffice API