Aller au contenu principal

Créer des passes de transport en masse

POST

https://api-v2.test.eldowallet.fr/transits/:transitId/passes/bulk

Traitement asynchrone. La réponse est une opération en masse : suivez son statut et ses résultats avec GET /bulk-operations/{operationId}.

À retenir
  • Le wallet doit avoir le type de pass TRANSIT activé.

Requête​

path parameters
  • transitId string required
    Identifiant du modèle de transport (`_id`).
header parameters
  • x-lang string
    Langue des messages d'erreur et des textes renvoyés : `fr` ou `en`.
    enum: en, frdefault: "en"
Body application/json required
  • webhookUrl string
    URL de webhook facultative, appelée à la fin de l'opération. En-têtes d'authentification : ajoutez `#headers=Authorization:Bearer%20token` à l'URL.
    example: https://example.com/webhook#headers=Authorization:Bearer%20token
  • forceSync boolean
    Exécute l'opération de manière synchrone (moins de 1 000 éléments). Si la valeur est `true` et que la requête contient 1 000 éléments ou plus, elle est rejetée.
    default: false
  • items object[] required
    Liste des titres de transport à créer.
    • departureDate string required
      Date calendaire ISO 8601 (`YYYY-MM-DD`).
      example: 2000-01-01
    • arrivalDate string required
      Date calendaire ISO 8601 (`YYYY-MM-DD`).
      example: 2000-01-01
    • departureTime string
      Heure au format 24 h (`HH:mm`).
      pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$example: 00:00
    • arrivalTime string
      Heure au format 24 h (`HH:mm`).
      pattern: ^([0-1][0-9]|2[0-3]):[0-5][0-9]$example: 01:00
    • originStationCode stringmaxLength: 3example: str
    • destinationStationCode stringmaxLength: 3example: str
    • expirationDate stringexample: 2000-01-01
    • flightNumber string
    • gate string
    • seat string
    • originName stringmaxLength: 13
    • destinationName stringmaxLength: 13
    • tripNumber string
    • tarif string
    • customBackFields object[]
      • key string
        Générée côté serveur (slug dérivé du libellé et de la position). N'envoyez pas ce champ : il est ignoré et toujours régénéré.
      • label string required
      • value string required
      • type object required
    • enableSendEmailOrSms booleandefault: false
    • firstName string required
    • lastName string required
    • email string <email> required
    • phoneNumber string
    • barcode string
  • enableSendEmailOrSms boolean required
    Indique s'il faut envoyer des notifications par e-mail ou SMS.
    example: true

Réponses​

Schéma application/json
  • operationId string required
    Identifiant unique de l'opération en masse.
    example: 507f1f77bcf86cd799439011
  • totalItems number required
    Nombre total d'éléments de l'opération.
    example: 100
  • successCount number required
    Nombre d'éléments traités avec succès.
    example: 95
  • failureCount number required
    Nombre d'éléments en échec.
    example: 5
  • status string required
    Current status of the operation
    enum: pending, processing, completed, failedexample: pending
    • operationErrors object[]
      Liste des erreurs des éléments en échec.
      • itemId string required
        Identifiant de l'élément en échec.
        example: 507f1f77bcf86cd799439011
      • message string required
        Message d'erreur.
        example: Client not found
      • code string
        Code d'erreur, s'il est disponible.
        example: 404:MODEL_NOT_FOUND
    • results object[]
      Liste des résultats des éléments traités avec succès.
      • itemId string required
        Identifiant de l'élément.
        example: 507f1f77bcf86cd799439011
      • result object
        Données du résultat.
    • createdAt string <date-time> required
      Date et heure de création de l'opération.
      example: 2024-01-01T00:00:00.000Z
    • completedAt string <date-time>
      Date et heure de fin de l'opération.
      example: 2024-01-01T00:05:00.000Z

    Les nouveautés de l'API, une fois par mois

    Nouveaux endpoints, changements à prévoir, guides et cas d'usage. Pas de spam, désinscription en un clic.

    Signaler un problème technique

    Une erreur de l’API, un pass qui ne se met pas à jour, un e-mail qui n’arrive pas ? Décrivez le problème : notre équipe technique vous répond.

    Pour une réponse rapide, indiquez :

    • La méthode et l’endpoint (ex. POST /clients)
    • Le code d’erreur renvoyé (errorCode) et le corps envoyé
    • La date et l’heure de l’appel
    • Les identifiants concernés (client, modèle, pass)

    N’y mettez jamais de jeton d’API ni de mot de passe.

    Assistant IA

    Beta

    Chargement…

    Réponses générées par IA (Claude) : vérifiez les points importants.

    Connectez-vous pour utiliser l'assistant