Pour les développeurs

Construisez avec Malambi

SDK TypeScript, API REST avec 220+ contrôleurs, WebSocket temps réel. Intégrez la flotte, le tracking, le taxi à vos applications.

43 ressources · 211 docs · API Bearer auth · accès sur invitation

SDK Officiel

Malambi SDK pour TypeScript

Le SDK officiel encapsule l'authentification, le polling de positions, les WebSockets et tous les modules métier. Auto-injection des credentials, types stricts, intercepteurs Axios.

  • Authentification (token + refresh)
  • Module LocateGroups (groupes & véhicules)
  • WebSockets natifs avec heartbeat
  • Types TypeScript alignés avec l'API
Demander un accès
app.ts
import { MalambiSDK } from '@malambi/sdk';

const sdk = new MalambiSDK();

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

// Liste des véhicules d'un groupe
const vehicles = await
    sdk.locateGroups.getVehiclesByGroup(123);

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

Le SDK en un clin d'œil

AuthManager + 7 modules métier + client Helper, branchés sur les endpoints serveur. Lazy-init, types stricts, intercepteurs Axios.

Diagramme architecture SDK Malambi TypeScript : MalambiSDK → AuthManager + Modules + Helper API client → serveur
Ce que contient le SDK

7 modules clés, 100+ accesseurs

Chaque module est lazy-instancié à la première utilisation. Hérite d'un BaseModule commun (HTTP avec auto-auth, parsing dates, pagination).

AuthManager

Login, refresh, session restore, change password. Auto-injection des tokens dans toutes les requêtes.

Tracking

Positions live via WebSocket, statuts véhicules, alertes, trips du jour. Callbacks temps réel.

LocateGroups

Groupes & véhicules : getGroups, getVehiclesByGroup, search, statistiques.

Reports

67 rapports en 9 catégories (alarmes, conducteurs, flotte, carburant…). PDF/XLS/CSV, livraison email.

Playback

Rejeu de trajets historiques avec contrôles temporels, vitesse de lecture, événements.

Trace

Historique brut de positions sur période. Export CSV. Idéal pour audits ou BI.

GeoZones

Géofencing : créer/lister zones, alertes entrée/sortie, polygones & cercles, hiérarchie.

+90 modules sys/frm

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

Doc complète des modules sur le DevPortal →

Intégration framework

Prêt à copier dans ton projet

Patterns recommandés pour les frameworks majeurs. Auth + session restore en 1 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 };
}

Plus d'exemples (12 snippets, tracking live, reports, mobile) sur le DevPortal →

API REST

Helper — l'API qui pilote Malambi

Un seul endpoint /Helper, des centaines de contrôleurs IRequest. Pattern simple et puissant.

220+

Contrôleurs documentés

FleetMan core, plugins, librairie tools.

19

Plugins métier

Chacun avec son namespace API.

JSON

Format de réponse

Réponses structurées avec total/rows pour pagination.

# Liste simplifiée des véhicules
GET /Helper?frm=GetVehiclesSimple

# Arbre des géozones avec checkboxes
GET /Helper?frm=GetGeozonesTree&checkbox=1

# Envoi SMS via SmsSender
POST /Helper?frm=SmsSender
   &to=237699123456&text=Hello
Temps réel

WebSocket pour le live

Heartbeat 4 niveaux

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

Auto-reconnexion

Détection coupure, retry exponentiel jusqu'à 10 tentatives.

Multi-canal

Positions, chat, alertes, présence, course taxi en temps réel.

Accès

Où trouver quoi

Deux espaces protégés selon votre profil — l'un pour les développeurs et intégrateurs, l'autre pour l'équipe Malambi.

Prêt à construire ?

Demandez un accès développeur — clés API + accès aux endpoints sandbox.

Obtenir un accès dev