For developers

Build with Malambi

TypeScript SDK, REST API with 220+ controllers, real-time WebSockets. Integrate fleet, tracking and taxi data into your applications.

43 resources · 211 docs · Bearer auth · invitation-only access

Official SDK

Malambi SDK for TypeScript

The official SDK wraps authentication, position polling, WebSockets and every business module. Auto-injected credentials, strict types, Axios interceptors.

  • Authentication (token + refresh)
  • LocateGroups module (groups & vehicles)
  • Native WebSockets with heartbeat
  • TypeScript types aligned with the API
Request access
app.ts
import { MalambiSDK } from '@malambi/sdk';

const sdk = new MalambiSDK();

// Authentication
await sdk.auth.login('user', 'password');

// Vehicles inside a group
const vehicles = await
    sdk.locateGroups.getVehiclesByGroup(123);

// Live positions over WebSocket
sdk.live.on('position', (v) => {
    console.log(v.tag, v.loc);
});
Architecture

The SDK at a glance

AuthManager + 7 business modules + Helper API client, wired to the server endpoints. Lazy-init, strict types, Axios interceptors.

Malambi TypeScript SDK architecture diagram: MalambiSDK → AuthManager + Modules + Helper API client → server
What the SDK ships with

7 core modules, 100+ accessors

Each module is lazy-instantiated on first use. Inherits from a common BaseModule (HTTP with auto-auth, date parsing, pagination).

AuthManager

Login, refresh, session restore, change password. Auto-injects tokens into every request.

Tracking

Live positions over WebSocket, vehicle status, alerts, today's trips. Real-time callbacks.

LocateGroups

Groups & vehicles: getGroups, getVehiclesByGroup, search, statistics.

Reports

67 reports across 9 categories (alarms, drivers, fleet, fuel…). PDF/XLS/CSV, email delivery.

Playback

Replay historical trips with time controls, playback speed, event markers.

Trace

Raw position history over a period. CSV export. Ideal for audits or BI.

GeoZones

Geofencing: create/list zones, entry/exit alerts, polygons & circles, hierarchy.

+90 sys/frm modules

GetVehicles, GetDrivers, SmsSender, alarmpreview, camera, candata, chat, fueltools…

Full module reference on the DevPortal →

Framework integration

Ready to copy into your project

Recommended patterns for the major frameworks. Auth + session restore in one hook/composable/service.

// hooks/useMalambiAuth.ts
import { useState, useEffect } from 'react';
import MalambiSDK from '@malambi/sdk';

export function useMalambiAuth() {
    const [sdk] = useState(() => new MalambiSDK({
        baseUrl: process.env.REACT_APP_MALAMBI_URL,
    }));
    const [user, setUser] = useState(null);

    useEffect(() => {
        const stored = localStorage.getItem('malambi_session');
        if (stored) {
            const s = JSON.parse(stored);
            sdk.restoreSession(s.token, s.user, s.expiresAt)
               .then(ok => ok && setUser(sdk.getCurrentUser()));
        }
    }, [sdk]);

    return { sdk, user };
}

More examples (12 snippets, live tracking, reports, mobile) on the DevPortal →

REST API

Helper — the API that drives Malambi

A single endpoint /Helper, hundreds of IRequest controllers. A simple, powerful pattern.

220+

Documented controllers

FleetMan core, plugins, tools library.

19

Business plugins

Each with its own API namespace.

JSON

Response format

Structured responses with total/rows for pagination.

# Simplified vehicle list
GET /Helper?frm=GetVehiclesSimple

# Geozones tree with checkboxes
GET /Helper?frm=GetGeozonesTree&checkbox=1

# Send an SMS via SmsSender
POST /Helper?frm=SmsSender
   &to=237699123456&text=Hello
Real-time

WebSocket for live data

4-level heartbeat

PING/PONG, application-level, network detection, inter-server.

Auto-reconnect

Disconnect detection, exponential retry up to 10 attempts.

Multi-channel

Real-time positions, chat, alerts, presence, taxi rides.

Access

Where to find what

Two protected spaces depending on your role — one for developers and integrators, the other for the Malambi team.

Ready to build?

Request developer access — API keys plus access to the sandbox endpoints.

Get developer access