Managing API users

Related Manuals

• Introduction to Fleet Complete API
• API User management
• API calls generic description
• API Customer management
• Vehicle management
• System callbacks
• Creating API account
• API Tasks management
• Vehicle bookings management

User management

API user is like regular user in FCPlus, only difference is that it has assigned API key, what is visible only for FCPlus administrators. To get one API key, you have to connect your sales representative or technical support. They create API user or attach API key to some existing user, and if you have permission to change persons or roles, you can fine-tune API user permissions.

Main principle with API user is: give it permissions as less as possible and as much as needed. API users may have access to sensitive data, and can make changes in your account, so if API key falls into false hands, it would be better, if it has access to only those commands, what are required for work.

It's good practice to have separate role for API user, what does not use permissions assigned to other people, like illustrated in following screenshot.

If your API user gets error, that some permission is missing, please look to roles assigned to API user, and give more permissions. For example, if your API user gets following error when asking data for fuel report:

app.ecofleet.com/seeme/Api/Reports/getReportConf?id=fuel&key=apidemo-NJ8V7PENgkau5FYH

  8       No rights for this report

Then you have to give more permissions for API role to give access to that report.