Créer un certificat
Configuration de la requête
- La requête est authentifiée avec un token applicatif à ajouter à l'entête de la requête :
Authorization: Bearer <token>
- Le fuseau horaire est requis
- L'identité est requise
- Le filtrage géographique est optionnel
- Les dates de début et de fin sont optionnelles
- La date de fin la plus récente possible est J-6
- La date de début la plus ancienne est le 1er janvier de l'année précédente
Voir la création avancée pour le détail des options
Création simple
Les données requises pour la création ne concernent que l'identité de la personne et le fuseau horaire.
Par défaut, l'attestation sera générée pour l'année précédente sans restrictions géographiques.
Chaque appel, même si les paramètres sont les mêmes, entraine la création d'une attestation unique.
Les attestations ne peuvent être supprimées. Contactez notre équipe au besoin.
Astuce
Vous pouvez récupérer le fuseau horaire de l'utilisateur en Javascript.
const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
Body
Required
-
L'identité peut être passée de 3 manières différentes :
phone
: le numéro de téléphone complet au format ISOphone_trunc
+operator_user_id
: le numéro de téléphone tronqué plus votre identifiant utilisateuroperator_user_id
: votre identifiant utilisateur uniquement (valable uniquement si vous avez transmis des trajets avec le couplephone_trunc
+operator_user_id
)
Additional properties are NOT allowed.
-
fuseau horaire
-
Date de début au format ISO. Sélectionne les trajet >= date
-
Date de fin au format ISO nécessairement supérieur à start_at. Sélectionne les trajets < date
-
Pour sélectionner des trajets en fonction de leur point de départ et d'arrivée, il est possible de les préciser avec la clé
positions
. Tous les trajets ayant un départ et une arrivée dans un rayon de1km
autour des points donnés seront inclus à l'attestation.Position lat/lon
At least
2
elements.
Responses
-
OK
-
Non authentifié. Le token applicatif est manquant ou invalide
-
Accès refusé Les permissions de votre token applicatif ne vous permettent pas de créer une attestation. Vous pouvez générer un nouveau token et réessayer. Si le problème persiste, contactez notre équipe.
-
L'identité n'a pu être trouvée. Vérifiez les identifiants envoyés.
curl \
--request POST 'http://api.example.com/certificates' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"identity":{"phone":"+33601020304, +590690101010","phone_trunc":"+336010203, +5906901010","operator_user_id":"d2e8a6c4-9e3a-4b6f-8e8d-9f7a6b5c4d3e"},"tz":"Europe/Paris","start_at":"2021-01-01T00:00:00+01:00","end_at":"2021-07-01T00:00:00+02:00","positions":[{"lat":47.682821,"lon":-0.557483}]}'
{
"identity": {
"phone": "+33601020304, +590690101010",
"phone_trunc": "+336010203, +5906901010",
"operator_user_id": "d2e8a6c4-9e3a-4b6f-8e8d-9f7a6b5c4d3e"
},
"tz": "Europe/Paris",
"start_at": "2021-01-01T00:00:00+01:00",
"end_at": "2021-07-01T00:00:00+02:00",
"positions": [
{
"lat": 47.682821,
"lon": -0.557483
}
]
}
{
"uuid": "8a9d2da9-39e3-4db7-be8e-12b4d2179fda",
"created_at": "2020-01-01T00:00:00+01:00",
"meta": {
"tz": "Europe/Paris",
"positions": [
{
"lat": 47.682821,
"lon": -0.557483
}
],
"driver": {
"total": {
"trips": 42,
"week_trips": 42,
"weekend_trips": 42,
"distance": 42.0,
"amount": 42.0
},
"trips": [
{
"type": "driver",
"datetime": "2025-05-04T09:42:00Z",
"trips": 42,
"distance": 42.0,
"amount": 42.0
}
]
},
"passenger": {
"total": {
"trips": 42,
"week_trips": 42,
"weekend_trips": 42,
"distance": 42.0,
"amount": 42.0
},
"trips": [
{
"type": "driver",
"datetime": "2025-05-04T09:42:00Z",
"trips": 42,
"distance": 42.0,
"amount": 42.0
}
]
}
}
}
{
"code": 401,
"error": "Unauthorized"
}
{
"code": 403,
"error": "Forbidden"
}
{
"code": 404,
"error": "Not found"
}