Transférer depuis votre plateforme de suivi

Vos traceurs continuent d’envoyer là où ils le font aujourd’hui. Votre plateforme transfère leurs positions ici : ni SMS, ni passage aux véhicules.

Sur cette page

Traccar (et GPSWox)
Wialon et Navixy (Wialon IPS)
flespi
Toute autre plateforme : le webhook
Comment les unités sont associées

Activez-le dans la console : Flotte → Traceurs GPS → Plus → Connecter votre plateforme. Vous y trouvez le jeton de votre organisation et les adresses ci-dessous déjà remplies. Les unités que votre plateforme envoie sont associées à vos traceurs par leur IMEI ou leur identifiant ; celles que vous n’avez pas ajoutées y sont listées, chacune ajoutée d’un geste.

Attention :

Le jeton de ces adresses est la clé : gardez-le secret. S’il fuit, donnez un nouveau jeton au transfert dans la même fenêtre ; l’ancien cesse aussitôt de fonctionner.

Traccar (et GPSWox)

Dans traccar.xml, transférez les positions et les événements en JSON :

traccar.xml

&lt;entry key='forward.enable'&gt;true&lt;/entry&gt;
&lt;entry key='forward.url'&gt;https://nways.ng/v1/trackers/forward/VOTRE_JETON/traccar&lt;/entry&gt;
&lt;entry key='forward.json'&gt;true&lt;/entry&gt;
&lt;entry key='event.forward.enable'&gt;true&lt;/entry&gt;
&lt;entry key='event.forward.url'&gt;https://nways.ng/v1/trackers/forward/VOTRE_JETON/traccar&lt;/entry&gt;

N-Ways lit le uniqueId de l’appareil, la position (vitesse en nœuds) et, dans ses attributs, ignition, power, battery, batteryLevel, sat, totalDistance et alarm ; les événements ignitionOn, ignitionOff, alarm et deviceOverspeed. Sans JSON, un modèle d’URL fonctionne aussi :

cURL

https://nways.ng/v1/trackers/forward/VOTRE_JETON/osmand?id={uniqueId}&amp;lat={latitude}&amp;lon={longitude}&amp;timestamp={fixTime}&amp;speed={speed}&amp;bearing={course}

Wialon et Navixy (Wialon IPS)

Ajoutez un retranslator (Wialon) ou une cible de transfert (Navixy) au protocole Wialon IPS, vers le serveur trk.nways.ng, port 5039. L’identifiant unique de chaque unité est son IMEI, et son mot de passe est votre jeton.

flespi

Ajoutez un stream de type HTTP vers https://nways.ng/v1/trackers/forward/VOTRE_JETON/flespi, au format de messages par défaut de flespi. N-Ways lit ident, timestamp, position.*, engine.ignition.status, external.powersource.voltage, battery.* et vehicle.mileage.

Toute autre plateforme : le webhook

Envoyez (POST) du JSON à https://nways.ng/v1/trackers/forward/VOTRE_JETON/webhook, ou à https://nways.ng/v1/trackers/forward/webhook avec Authorization: Bearer VOTRE_JETON. Une position, un tableau, ou {"positions": [...]}, 500 au plus par requête et 2 Mo.

Une position

{"positions": [{
  "unitId": "356307042441013",
  "name": "Hiace 2",
  "lat": 6.6018, "lng": 3.3515,
  "time": "2026-10-23T09:41:00Z",
  "speedKmh": 42, "heading": 90,
  "ignition": true, "extVoltage": 12.6, "batteryPct": 88,
  "alarms": ["sos"]
}]}

Champ	Ce que c’est
`unitId` (ou `imei`)	Obligatoire. 4 à 40 lettres, chiffres, - ou _ : c’est ce qui associe l’unité à vos traceurs.
`lat`, `lng` (ou `lon`)	Degrés, WGS 84. Omettez-les pour un événement sans position.
`time` (ou `timestamp`)	ISO 8601, ou secondes ou millisecondes depuis l’époque. Par défaut : maintenant.
`speedKmh`, `heading`, `altitude`, `accuracy`, `sats`	km/h, degrés, mètres, mètres, satellites.
`ignition`, `extVoltage`, `batteryV`, `batteryPct`, `odometerKm`	Le contact, l’alimentation externe (V), la batterie et le compteur du véhicule.
`alarms`	`sos`, `power_cut`, `overspeed`, `low_battery`, `tow`, `crash`, `vibration`, `geofence`, `removal`.
`valid`	`false` : gardée dans le journal de l’appareil, jamais sur la carte.
`name`	Le nom de l’unité sur votre plateforme (il nomme le véhicule quand vous l’ajoutez).

La réponse est {"taken": 1, "unknown": ["<unités pas encore ajoutées>"]}. Erreurs : 401 INVALID_FORWARDING_TOKEN, 400 avec ce qui ne va pas et dans quelle position, 403 TRACKERS_OFF tant que N-Ways a désactivé vos traceurs, 413 au-delà de 2 Mo ou de 500 positions.

Comment les unités sont associées

Une unité dont l’IMEI ou l’identifiant est l’un de vos traceurs déplace son véhicule, et ses alarmes déclenchent vos alertes.
Une unité que vous n’avez pas ajoutée est listée dans la console, avec ce qu’elle a envoyé en dernier. Ajoutez-la d’un geste : un véhicule à son nom est créé.
Les positions à 0, 0 ou hors d’Afrique de l’Ouest, et celles venues du futur (une horloge sur le mauvais fuseau), restent dans le journal de l’appareil et ne déplacent jamais un véhicule.