Get started
IFMS is the Integrated Fleet Management System of the Ministry of Transport and Logistics. GPS and fleet-management providers send vehicle telemetry to IFMS: position, ignition state and related device data.
These docs explain how to connect your GPS or fleet system to IFMS. You do the work in the Developer Portal. These docs never ask for your credentials.
What integration means
You send telemetry through the IFMS gateway. It is the single, secure entry point for every provider. The gateway:
- authenticates your application with an OAuth 2.0 access token;
- works out your approved provider identity, so you never send it yourself;
- passes your batch to IFMS and returns the result.
IFMS checks each position on its own. The response tells you which positions were accepted, which were duplicates and which were rejected.
The Glossary explains the terms these docs use.
Two hosts, two jobs
| Host | What you use it for |
|---|---|
apim.kairosinnovations.dev | The Developer Portal (register, applications, keys) and the token endpoint. Nothing else. |
gw.kairosinnovations.dev | The telemetry gateway. The only address that accepts telemetry. |
Both hosts belong to the Integration environment. The Environments page lists the exact URLs.
Who does what
| Who | What they do |
|---|---|
| You, the provider | Register, create an application, subscribe it to the telemetry API, generate Production keys, get tokens and send telemetry. Keep your credentials and tokens safe. |
| IFMS administrator | Reviews and approves your Developer Portal account. |
| IFMS gateway | Checks your token and subscription, adds your provider identity and forwards your batch. |
| IFMS | Checks and stores each position, then returns counts and a list of failures. |
Your journey
First, read Before you begin and get your details ready. Then follow the seven onboarding steps: