Transports
Titres de transport (bus, train, bateau, avion, tram).
Créer un modèle de transport
Crée un modèle de transport (bus, train, bateau, avion, tram ou générique) et son modèle de pass Apple Wallet et Google Wallet. Envoyez la requête en `multipart/form-data` avec l'image `strip` (obligatoire) ; le `number` du modèle sert de numéro de trajet par défaut des passes.
Lister les modèles de transport
Liste, page par page, les modèles de transport du wallet pour un type donné (`type` obligatoire : `Bus`, `Boat`, `Train`, `Air`, `Generic` ou `Tram`).
Mettre à jour un modèle de transport
Met à jour un modèle de transport ; les passes déjà installés sont mis à jour. Les porteurs sont notifiés selon le modèle de notification `UPDATE_TRANSIT`. Accepte `multipart/form-data` (nouvelle image `strip`) ou `application/json`.
Supprimer un modèle de transport
Supprime un modèle de transport et son modèle de pass. La suppression est refusée (`400 HOTEL_HAS_PASSES`) tant que des passes existent pour ce modèle.
Obtenir un modèle de transport
Renvoie un modèle de transport du wallet à partir de son identifiant.
Créer un pass de transport
Crée un titre de transport pour un voyageur à partir d'un modèle de transport et renvoie son identifiant, son code-barres et son lien de téléchargement (`downloadLink`). Avec `enableSendEmailOrSms: true`, le titre est aussi envoyé par e-mail ou SMS (`email` ou `phoneNumber`).
Lister les passes d'un transport
Liste, page par page, les passes d'un modèle de transport, avec filtres par statut, date de création et recherche. Chaque pass inclut `departureDateTime`, `arrivalDateTime` (format `dd-MM-yyyy HH:mm`) et les types d'appareils sur lesquels il est installé (`devices`).
Obtenir un pass de transport
Renvoie un titre de transport à partir de son identifiant.
Mettre à jour un pass de transport
Met à jour un titre de transport (voyageur, trajet, horaires, siège, code-barres…) et le pass installé. Le porteur est notifié selon le modèle `UPDATE_TRANSIT` et ses préférences ; une requête sans changement renvoie le pass tel quel.
Obtenir un pass de transport par code-barres
Renvoie un titre de transport à partir de son code-barres, par exemple lors d'un contrôle.
Modifier le statut d'un pass de transport par code-barres
Marque un titre de transport comme utilisé (`status: USED`) ou annule cette validation (`status: UNUSED`), à partir de son code-barres. Le pass installé est mis à jour sans notification ; renvoie `PASS_ALREADY_REDEEMED` ou `PASS_NOT_REDEEMED` si le statut ne change pas.
Obtenir les statistiques des transports
Renvoie les statistiques des titres de transport du wallet : nombre total (`totalCustomers`), actifs (`totalActifCustomers`) et validés (`redeemedPassesCount`). Filtrez par modèle, par type de transport ou par période de création.
Créer des passes de transport en masse
Traitement asynchrone. La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
Mettre à jour des passes de transport en masse
La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
Supprimer des passes de transport en masse
La réponse est une opération en masse : suivez son statut et ses résultats avec `GET /bulk-operations/{operationId}`.
Mettre à jour un trajet
Met à jour les passes de transport qui partagent ce numéro de trajet.
Notifier les porteurs d'un trajet
Envoie une notification aux porteurs des passes de ce numéro de trajet.