Voir également Schema JSON.

Envoyer un trajet de covoiturage à l’API du Registre de Preuve de Covoiturage nécessite que plusieurs critères soient remplis.

• 1️⃣ Une entité “opérateur de covoiturage” est créée sur l’application du registre.

• 2️⃣ Un utilisateur appartenant à cet opérateur de covoiturage est administrateur.

• 3️⃣ L’administrateur opérateur crée un token applicatif.

• 4️⃣ Ce token applicatif est installé sur le serveur de l’opérateur qui va envoyer les données et sera passé dans le Header de chacune des requêtes.

• 5️⃣ Le serveur peut communiquer avec les serveurs suivants :

  1. Production : https://api.covoiturage.beta.gouv.fr​

  2. Pré-production : https://api-staging.covoiturage.beta.gouv.fr​

1️⃣ 2️⃣ - Accéder à l’application du registre

Afin de valider les critères 1️⃣ et 2️⃣ , veuillez à respecter la procédure Rejoindre le registre. En effet, ces opérations sont réalisées par un membre de l’équipe du Registre de preuve de covoiturage.

La procédure sera simplifiée et automatisée.

3️⃣ - Créer un token applicatif

Cette manipulation est réalisable, uniquement pour les utilisateurs dits administrateurs, sur l'interface applicative du Registre de preuve de covoiturage.

1. Créer un nouveau token ;

2. Donner un nom à ce token ;

3. Copier le token généré et le conserver de manière sécurisée. Il devra être envoyé dans le header de chaque requête serveur.

4️⃣ 5️⃣ - Logique de connexion au service

Le token applicatif donné lors de la création de l’application doit être envoyé dans les Headers des requêtes serveurs comme ceci :

Authorization: Bearer {token}

Seule la route POST /v2/journeys accepte l’authentification avec ce token. Une erreur 401 Unauthorized est retournée pour les tokens invalides. Un code de retour 201 Created est retourné quand la preuve est acceptée.

Limitations du nombre de requêtes

Le nombre de requêtes envoyées sur la route d'acquisition des preuves est de 20000 par minute. Au delà, merci de différer les envois en plusieurs blocs espacés de quelques minutes. Les autres routes de l'application ont des limites beaucoup plus basses.

Foire Aux Questions

Qu'est-ce qu'un trajet ?

Dans la base de données les trajets correspondent à des couples passager-conducteur contenant les informations d'un trajet effectué. Ainsi si dans un covoiturage le nombre de passager est de 2 alors deux couples sont envoyés au registre :

• Conducteur.rice 1 - Passager 1 : 10 km, etc.

• Conducteur.rice 1 - Passager 2 : 10,5 km, etc.

Quel est le délai d'envoi des preuves de covoiturage ?

Le registre a pour vocation d'agréger des preuves de covoiturage notamment dans l’objectif de lutter contre la fraude massive. Cette preuve de covoiturage est constituée d’un point de départ et d’arrivée. En conséquence, il n’est pas possible, aujourd’hui, pour le registre de délivrer des attestations de covoiturage, pendant un trajet afin d’obtenir une incitation en temps réel. En revanche, il est indispensable pour les organismes incitateurs d’obtenir des informations sur la réalisation d’un trajet au plus vite. En conséquence, un juste milieu doit être trouvé.

Le consensus trouvé avec les différentes parties prenantes est un délai de 5 jours (120 heures) entre la fin du trajet et la communication de la preuve de covoiturage. Nos processus de contrôle opérant durant 2 jours (48H00), notre promesse serait “retrouvez dans le registre de preuve de covoiturage, les trajets réalisés en maximum une semaine”.

Peut-on envoyer des preuves de covoiturage versionnées sur le registre ?

A l’heure actuelle, il n’est pas possible de modifier une preuve soumise au registre. C’est une évolution possible que nous étudions. Nous publierons très probablement un document sur le sujet avec la base de nos réflexions et vous inviterons à l’amender avec vos propositions et remarques.

​