N-Ways
Documentation développeursJournal des modifications

Vous développez avec N-Ways ?

Obtenir une clé d’API

Journal des modifications et versions

Ce qui a changé, et comment nous faisons évoluer les choses sans casser votre application.

Sur cette page

Journal des modifications

27 octobre 2026 : disponibilité générale

  • Toutes les API et tous les SDK sont en disponibilité générale ; plus aucune mention « aperçu ». Chaque API a la même promesse : des changements incompatibles seulement dans une nouvelle version, annoncés au moins 12 mois à l’avance. Comment fonctionnent les versions
  • Conditions 1.3 : les conditions propres à l’aperçu disparaissent ; les engagements de disponibilité viennent avec les formules Business et Enterprise. Conditions
  • Tarifs : les prix publiés sont les prix en vigueur.

27 octobre 2026 : le portugais

  • La documentation développeurs en portugais, avec la référence de l’API, sur /pt/developers.
  • SDK Maps 1.1 : lang: 'pt' affiche les noms en portugais quand il y en a. SDK Maps

27 octobre 2026 : arrêter un forfait mensuel

  • Arrêter la formule dans la Facturation de la console : le forfait court jusqu’à la fin du mois payé, sans nouvelle facture, puis les nouvelles livraisons sont en pause jusqu’à ce que vous choisissiez un forfait ; le crédit reste. Garder ma formule annule l’arrêt. Passer à l’API seule attend aussi la fin du mois payé. Tarifs
  • Conditions 1.2 : le renouvellement et l’arrêt du forfait mensuel, dans les conditions.

23 octobre 2026 : gérer ses livraisons sur N-Ways

  • Nouveau refus API_ACCESS_OFF (403) : une organisation qui gère ses livraisons sur N-Ways sans l’API a ses clés désactivées. Ajoutez l’API dans la console, Facturation, pour les utiliser ; les appels d’API sont alors payés à l’usage. Erreurs
  • Forfaits mensuels pour les entreprises qui gèrent leurs livraisons dans la console et N-Ways Business. Tarifs

16 octobre 2026 : une clé en une minute

  • Flotte : où va chaque véhicule. GET /fleet/routes donne, pour chaque véhicule en livraison, la route parcourue, la route à venir par chaque arrêt prévu (calculée par le moteur d’itinéraires) et ses arrêts numérotés dans l’ordre. Chaque véhicule a une colour (16 clés ; à la création ou avec PATCH /vehicles/{id}) utilisée sur toutes les cartes, et chaque livraison un ref court (#1042) pour les personnes ; les alertes portent taskRef et taskLabel. Référence de l’API
  • Plus d’étape d’approbation. Inscrivez-vous avec Google, Apple ou un e-mail, nommez votre entreprise, et votre clé est prête aussitôt, avec les étapes pour l’intégrer sur le web, Android, iOS ou en REST. Utilisation gratuite chaque mois.
  • Chaque refus dit exactement pourquoi et comment y remédier, avec un lien vers son entrée sur la page Erreurs dans error.details (l’ErrorInfo et le Help de Google) et les en-têtes CORS pour que le code du navigateur puisse le lire. Nouveaux motifs : PLATFORM_DISABLED (503 : la plateforme est coupée, votre clé est valable), PLATFORM_PREVIEW_ONLY, API_KEY_REVOKED (clés supprimées ou régénérées, qui répondaient API_KEY_INVALID), ORGANISATION_SUSPENDED (ex-PARTNER_SUSPENDED), ORGANISATION_CLOSED et API_KEY_PAUSED (ex-API_KEY_DISABLED). Les refus de restriction montrent ce qui a été vu et ce qui est autorisé ; les plafonds disent lequel et quand il se remet à zéro. Le SDK Maps pour le web 1.0.1 affiche le message sur la carte.
  • Au-delà des appels gratuits, le crédit paie quelle que soit la formule, Starter compris. Sans crédit, les appels au-delà des gratuits reçoivent 402 BILLING_DISABLED (c’était 403) avec un message invitant à ajouter du crédit. Erreurs

15 octobre 2026 : version 1 des API, des SDK et de la flotte

15 octobre 2026 : clés d’API

  • Les clés sont vérifiées : restrictions de site web, Android, iOS et IP, restrictions d’API (Cartes, Géocodage, Lieux, Itinéraires, Tarifs de course, Trafic, Photos), limites de débit par minute et plafonds journaliers. Les motifs d’erreur sont définitifs : voyez Erreurs.
  • X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sur chaque réponse autorisée ; Retry-After sur chaque 429.
  • La consommation au-delà des appels gratuits mensuels de chaque API est facturée sur le crédit prépayé ou sur facture selon le contrat (BILLING_DISABLED quand le crédit prépayé est épuisé).
  • Des réglages à l’échelle du projet : les API de votre formule s’appliquent à chaque clé, des limites peuvent couvrir toutes les clés d’un projet ensemble, et un projet suspendu reçoit 403 PARTNER_SUSPENDED. Voyez Erreurs.
  • SDK Maps 0.1.1 : une tuile refusée écrit maintenant aussi son code HTTP dans la console.

15 octobre 2026 : la documentation pour les développeurs

  • La documentation pour les développeurs.
  • SDK Maps pour le web 0.1 sous https://nways.ng/sdk/v0/nways-maps.js : createMap, thèmes clair et sombre, libellés en français, buildStyle pour votre propre style.
  • API documentées : Tuiles, Géocodage (avec les codes postaux NIPOST et GhanaPost GPS), Lieux, Itinéraires, Tarifs de course et Trafic.
  • Clés d’API : envoyez key= ou X-NWays-Api-Key avec chaque requête.

Comment fonctionnent les versions

  • Les API de services web portent leur version majeure dans le chemin : /maps/v1/. Au sein d’une version, nous ne faisons qu’ajouter : nouveaux points d’accès, nouveaux paramètres facultatifs, nouveaux champs dans les réponses. Écrivez votre code pour qu’il ignore les champs qu’il ne connaît pas.
  • Un changement incompatible (supprimer ou renommer un champ, changer le sens d’un paramètre) arrive sous une nouvelle version, /maps/v2/. L’ancienne continue de fonctionner au moins 12 mois après que la nouvelle est stable.
  • Les SDK Maps suivent le versionnage sémantique. /sdk/v1/ sert toujours la dernière 1.x ; /sdk/v1.0.0/ et les versions exactes suivantes ne changent jamais. /sdk/v0/ sert toujours l’ancienne 0.1.
  • Les données de la carte (routes, lieux, codes postaux) changent chaque jour, à mesure que les gens corrigent la carte. Ce n’est pas un changement de version.

Abandons

Aucun pour l’instant. Quand quelque chose est abandonné, il est indiqué ici avec ce qui le remplace et la date à laquelle il cesse de fonctionner, et les partenaires qui l’utilisent reçoivent un e-mail.

État du service et assistance

Assistance en anglais ou en français, et l’état du service.