EasyTrack API

Envoie un code OTP à 6 chiffres à l'adresse email fournie.

Body

{
  "email": "user@example.com",
  "lang": "fr"        // optionnel : fr, en, de, it, es, pt, nl, tr
}

Réponse

{
  "success": true,
  "message": "Code envoyé par email",
  "expires_in": 600
}

Vérifie l'OTP et retourne un jeton Bearer.

Body

{
  "email": "user@example.com",
  "code":  "123456"
}

Réponse (succès)

{
  "success": true,
  "token": "eyJhbGci…",           // Bearer token
  "expires_at": "2026-08-01T…Z",
  "user": {
    "id": 42,
    "email": "user@example.com",
    "role": "client",
    "is_2fa_enabled": false
  }
}

Réponse (2FA requis)

{
  "success": true,
  "requires_2fa": true,
  "pending_token": "…"            // à utiliser dans /auth/verify-2fa
}

Envoie un lien magique par email permettant une connexion sans code. Utile pour des liens embarqués dans des emails.

{ "email": "user@example.com", "lang": "fr" }

Retourne le profil de l'utilisateur connecté.

Révoque le jeton courant.

Dernière position connue de tous les devices auxquels le compte a accès.

Query params

Réponse

{
  "success": true,
  "positions": [
    {
      "imei": "862272081390363",
      "latitude": 46.2044,
      "longitude": 6.1432,
      "speed": 42,
      "angle": 187,
      "ignition": 1,
      "server_timestamp": "2026-06-30T14:22:08Z",
      "address": "Rue de Bâle 14, 1201 Genève, Suisse"
    }
  ]
}

Positions filtrées (replay quality) pour un device sur une plage temporelle.

Positions filtrées pour un IMEI (raccourci).

Export brut paginé (raw_positions) - tous les points GPS reçus. Utilisez la pagination via page.

Réponse

{
  "success": true,
  "imei": "…",
  "page": 0,
  "page_size": 5000,
  "count": 4823,
  "has_more": false,
  "positions": [ /* … */ ]
}

Liste des devices assignés au compte connecté.

{
  "success": true,
  "devices": [
    {
      "id": 12, "imei": "862272081390363",
      "plate": "GE888222", "model": "Vivaro",
      "type": "vehicle",
      "is_active": 1,
      "last_seen_at": "2026-06-30T14:22:08Z"
    }
  ]
}

Vue optimisée pour dashboard temps réel : liste des devices + dernière position + état allumage/mouvement en une seule requête.

Détail d'un device par son IMEI.

Jours où chaque device a été actif (utile pour construire un date picker n'affichant que les dates avec données).

Liste des geofences du compte.

Crée une geofence circulaire ou polygonale.

{
  "name":  "Dépôt Genève",
  "type":  "circle",             // "circle" | "polygon"
  "center":  { "lat": 46.20, "lng": 6.14 },
  "radius_m": 250,
  "device_imeis": ["862272081390363"],
  "trigger_on":  ["enter", "exit"]
}

Met à jour une geofence.

Supprime une geofence.

Liste des alertes configurées pour le compte (vitesse, kilométrage, geofence, batterie…).

Crée une règle d'alerte.

{
  "type": "speed",                // speed | mileage | geofence | battery | offline
  "name": "Excès de vitesse",
  "threshold": 130,               // km/h pour speed
  "device_imeis": ["…"],
  "notify": ["email", "push"]
}

Liste des configurations de rapports du compte.

Crée une configuration de rapport (quotidien / hebdo / mensuel).

{
  "interval":       "weekly",        // daily | weekly | monthly
  "device_imeis":   ["…"],
  "email_to":       "user@example.com",
  "sections": {
    "summary":  true,
    "stats":    true,
    "trips":    true,
    "parkings": true,
    "alerts":   true
  }
}

Crée automatiquement une configuration hebdomadaire par défaut incluant tous les devices du compte.

Génère un rapport à la demande, avec option de plage personnalisée. Retourne un token public permettant d'accéder au PDF.

{
  "period_start": "2026-06-15T00:00:00Z",
  "period_end":   "2026-06-22T00:00:00Z",
  "email":        null                       // null = ne pas envoyer d'email
}

{
  "success": true,
  "id":      1287,
  "token":   "4cbc3a9bc89e783682a411…",
  "public_url": "https://api.easytrack.ch/reports/pdf/4cbc3a9…"
}

Historique des exécutions d'un rapport.

Sert le PDF final. Content-Type application/pdf. Nom de fichier : EASYTRACK-YYYY-MM-DD-<CODE>.pdf. Aucun header d'auth n'est nécessaire : la possession du token fait foi.

Liste des liens de partage actifs.

Crée un lien de partage limité dans le temps.

{
  "name":         "Campagne juin 2026",
  "device_imeis": ["862272081390363", "862272081390400"],
  "expires_at":   "2026-07-05T18:00:00Z"    // ISO 8601 ou null (permanent)
}

{
  "success": true,
  "id":     37,
  "token":  "a1b2c3d4e5f6g7h8"              // → https://my.easytrack.ch/open/share/<token>
}

Met à jour un lien (renommage, activation/désactivation, changement d'expiration).

Endpoint public retournant la carte HTML avec les devices autorisés. Aucun header d'auth : le token est la clé d'accès. Expire automatiquement selon expires_at.