Lister les stations de transport

  • Réservation
  • Transport
  • 1 route
Comment récupérer les stations de transport disponibles pour une locale donnée ?

Ce scénario explique comment récupérer les stations de transport disponibles pour une locale donnée. Il permet aussi de filtrer les résultats selon l'usage B2C ou B2B et de limiter l'affichage aux stations du même pays que la station actuellement sélectionnée.

Il convient aux parcours de recherche transport, de préparation de devis et d'aide à la vente.

Vue d'ensemble

Ce scénario permet d'alimenter une interface de sélection de ville de départ ou de station de transport à partir d'une locale donnée.

Prérequis

  • Un header accept-language correspondant à la locale ciblée.
  • Éventuellement un filtre tags pour distinguer les usages b2c et b2b.
  • Optionnellement le paramètre permettant de restreindre le résultat au pays de la station sélectionnée.

Résultat attendu

L'application obtient une liste exploitable de stations de transport avec leur identifiant, leur libellé, leur type et leurs tags d'usage.

1

Lister les stations de transport disponibles

Obligatoire

Utilisez GET/v1/transport_stations pour récupérer les stations de transport disponibles pour une locale donnée et alimenter un sélecteur de départ ou d'arrivée.

Prerequis

  • Un header accept-language valide, par exemple fr-FR.
  • Une x-api-key valide.
  • Facultativement un filter ou current_transport_station=true pour restreindre les résultats.

Calling CURL

curl -X 'GET' \
  'https://api.clubmed.com/v1/transport_stations?filter=tags==b2b&current_transport_station=true' \
  -H 'accept: application/json' \
  -H 'accept-language: fr-FR' \
  -H 'x-api-key: YOUR_API_KEY'

Example answer

[
  {
    "id": "CDG",
    "city_id": "PAR",
    "type": "AIRPORT",
    "label": "Paris-Roissy Charles de Gaulle",
    "is_main_city_station": true,
    "tags": ["b2c"]
  }
]

info: Réutilisez id, city_id, type et label pour piloter un sélecteur de station dans le parcours transport.

Codes de reponse

  • OK Response (200): retourne la liste des stations de transport correspondant au contexte demandé.
  • Error (400): la requête ou le filtre est invalide.
  • Error (401): non documente dans le Swagger.
  • Error (404): non documente dans le Swagger.
GET/v1/transport_stations
Voir plus