Stay updated on API status via Twitter

May 24, 2013

 

 

Dear e-conomic developer,In this edition of the e-conomic developer newsletter, you can see how to get updates on the e-conomic API status, learn about public and private app IDs, get tips on administrator access to the API, and more.

 

 

Stay updated on API status via Twitter

e-conomic API account on Twitter

We have created an e-conomic API account on Twitter to keep you updated on the status of our API. Follow the Twitter account to be notified directly any time there is an API-related production problem, either caused by the API itself or a general e-conomic issue.

This way, you can save time and effort on trouble-shooting, communication etc. in case your app is experiencing operational issues caused by the e-conomic API. Others in your organization, e.g. app supporters and app users, may also benefit from these updates, so please consider sharing the link to our Twitter account with the relevant people around you.

In addition to receiving updates, you can also use the e-conomic API Twitter account to ask questions or make comments related to the API status directly to our operations team. If you have technical questions that are not related to operations, please continue to use the API Forum or contact our API Team.

App IDs

Introducing public and private app IDs

The app ID used to identify apps created in e-conomic has been divided into two separate app IDs:

  • A public app ID used to identify the app when requesting users to grant access to the app
  • A private app ID used to access data through the e-conomic API

This split prevents malicious attempts to obtain another developer’s app ID through a request URL and use it for accessing data via the e-conomic API. New apps are created with different public and private app IDs. For existing apps, the two IDs are identical, but you can change one or both IDs to maximize protection.

You can learn more about how to use public and private app IDs for connecting to the e-conomic API in our connection tutorial.

Easier interaction with new API Forum

The API Forum has been redesigned to encourage easy dialog and interaction between developers.


With the new forum, you can:

  • Create your own tags for your posts
  • Vote posts up and down
  • Mark replies as best answer
  • Use tags for improved navigation and overview
  • See most popular posts and tags
  • Read posts from most active users

Get more info on what you can do in the new API Forum, and register as a new user if you haven't done so already.

Note that the changes to the API Forum mean that existing users will need to reset their password in order to log in. Your existing user profile and all your posts have of course been retained.

Connect as administrator

How to connect to the API as an administrator

Here are a few tips for you if you want to set up administrator access through the API:

Use the ConnectAsAdministrator method to access the API as an administrator. You need to specify the agreement number, user ID and password of the administrator, as well as the agreement number of the company whose data you want to access.

To set up a more user-friendly administrator access, you can also use the ConnectAsAdministratorWithCustomerNumber method. This allows you to identify the client company by the administrator's customer number for the company, rather than by the e-conomic agreement number.

If you want only administrator users to access data through your app, you can edit the master information of your company users and remove the tick in 'Access via API'. To see if an agreement is an administrator agreement, simply log on using the agreement details and look out for an 'Administrator' tab.

Note that for non-administrator access, we strongly recommend that you use the new ConnectWithToken method.

Visit the e-copedia to get more info on the Administrator module in e-conomic.

Bookkeeping

Define app access using Bookkeeping role

A Bookkeeping role – basically corresponding to the ‘Bookkeeping’ tab in e-conomic – has been added to the list of access levels for apps using the new API connection model.

Combined, this new role and the existing Sales and Project employee roles cover most of the available API functionality without requiring superuser access.

Additionally, the Sales role now includes access to the ‘Employee’ and ‘EmployeeGroup’ entities.

See the list of role-based permissions to get full info on the entities available for each role.

Apps

Getting Started

To get started building apps and integrations, take a look at our Developer Network pages where you'll find all the resources available to you.

For info about the API, check out the Developer Toolkit, the API Documentation or visit the API Forum. Also take a look at the SOAP API (also available in a WSDL version).

For feedback on your ideas or help promoting your app, contact the Apps Team. For hands-on technical issues, you can turn to the API Team for assistance.

Happy developing!