Comptes
Comptes web des entreprises clientes (pilotage de flotte).
Lister les comptes web d'une entreprise
Scope requis : USERS_READ.
Seuls les comptes de pilotage de flotte (FLEET_ADMINISTRATOR, DAF) sont
renvoyés. Les chauffeurs relèvent de GET /v1/papi/drivers.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
Lister les comptes web d'une entreprise › Responses
Comptes de l'entreprise
Créer un compte web chez une entreprise cliente
Scope requis : USERS_WRITE.
Le compte reçoit un courriel d'activation contenant un lien à usage unique, valable 72 h. Aucun mot de passe ne transite par l'API.
Les coordonnées doivent être celles de l'entreprise cliente. Un email ou un
téléphone appartenant à un compte apporteur est refusé en
422 RESELLER_SELF_ASSIGNMENT : un compte client donne accès à la surface de
gestion de flotte de cette entreprise, qui n'est pas votre périmètre.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
Headers
X-Idempotency-KeyValeur unique par opération — un UUID convient. Rejouée à l'identique dans les 24 h, la requête renvoie la première réponse au lieu de créer un doublon.
Créer un compte web chez une entreprise cliente › Request Body
nameemailSert à l'authentification et reçoit le lien d'activation.
phoneNumberrolelanguageCréer un compte web chez une entreprise cliente › Responses
Compte créé, courriel d'activation envoyé
Mettre à jour un compte web
Scope requis : USERS_WRITE.
path Parameters
companyIdIdentifiant d'une entreprise de votre portefeuille.
userIdHeaders
X-Idempotency-KeyValeur unique par opération — un UUID convient. Rejouée à l'identique dans les 24 h, la requête renvoie la première réponse au lieu de créer un doublon.
Mettre à jour un compte web › Request Body
nameemailphoneNumberrolestatusMettre à jour un compte web › Responses
Compte mis à jour