L'API WAYKOD,
endpoint par endpoint.

Échanger un token contre une position

Le cœur de l'offre. Renvoie une position exploitable, des repères et un score de fiabilité. Ne renvoie jamais l'identité du titulaire : vous avez besoin d'un lieu, pas d'une personne.

Erreurs

Chaque appel réussi compte dans votre quota mensuel. Les échecs sont journalisés mais non facturés.

Résoudre plusieurs tokens en un appel

Pour qui prépare une tournée. Cinquante commandes, cinquante tokens : les résoudre un par un, c'est cinquante allers-retours réseau avant que le premier camion ne démarre. Aucune course n'est créée chez WAYKOD — vous gardez vos commandes dans votre système, vous venez chercher des adresses.

Erreurs

Un lot ne casse jamais en entier : chaque token porte son propre statut — RESOLVED, MALFORMED, NOT_FOUND, EXPIRED, REVOKED, NO_ADDRESS — et la réponse reste 200. Facturé au token résolu, pas à la requête ; les doublons sont écartés avant d'être comptés. Le débit par minute, lui, ne compte qu'un appel.

Tracer un itinéraire vers un token

Le chemin depuis un point que vous donnez jusqu'à l'adresse désignée par le token : distance, durée, tracé et étapes. C'est l'usage même du token pour qui livre — votre chauffeur n'a pas besoin de connaître le quartier, ni le nom de la rue.

Erreurs

`mode` vaut DRIVING, WALKING ou CYCLING. `avoid` accepte jusqu'à trois contournements, `alternatives` renvoie les variantes avec leurs durées réelles. Chaque tracé est visible par le titulaire du token dans son application : il doit pouvoir constater qu'on a cherché son domicile.

Relire vos vérifications passées

Les vérifications faites avec vos propres clés, de la plus récente à la plus ancienne. Utile pour rapprocher votre facturation ou constater vos échecs d'intégration.

Votre compte

Société, forfait, consommation du mois, équipe et clés émises. La clé en clair n'y figure jamais : seul son préfixe subsiste.

Cette documentation, en JSON

Le catalogue que vous lisez, construit depuis la table de routage de l'API. Hors quota : le consulter ne coûte aucun appel facturable. Utile pour générer un client, ou vérifier après une mise à jour quels endpoints vos clés atteignent.

Enregistrer une course

Crée une livraison visant un token. La position n'est pas à fournir : elle est résolue depuis le token au moment de la création.

Erreurs

Lister vos livraisons

Vos courses, de la plus récente à la plus ancienne.

Consulter une livraison

Le détail d'une course, son historique de statuts inclus.

Attribuer une course à un chauffeur

Le chauffeur doit appartenir à votre flotte.

Erreurs

Lister vos chauffeurs

Votre flotte, avec disponibilité et vérification d'identité.

Positions en direct

Dernière position connue de chaque course engagée. Conçu pour être interrogé en boucle par une carte de supervision.

Consulter un chauffeur

Fiche d'un chauffeur de votre flotte : véhicule, disponibilité, note moyenne et courses effectuées.

Erreurs

Enrôler un chauffeur

L'enrôlement vous appartient : c'est vous qui vérifiez les papiers de vos chauffeurs. Le compte est créé sur le numéro de téléphone, qui sert aussi d'identifiant de connexion à l'application Chauffeur.

Erreurs

Modifier un chauffeur

Seuls les champs envoyés sont modifiés. Le numéro de téléphone en fait partie — un chauffeur change de numéro — et le mot de passe se remplace sans connaître l'ancien : un responsable de flotte n'a pas à le connaître pour le réinitialiser.

Erreurs

Retirer un chauffeur de la flotte

Le compte passe en « suspendu » et le chauffeur cesse d'être disponible ; rien n'est effacé. Son historique de courses reste consultable, et une réactivation suffit à le remettre en service — ce qu'une suppression sèche interdirait.

Erreurs