MOBILITY API

Un contrat d’intégration stable devant plusieurs partenaires.

Cette vue présente les principes du modèle canonique et du cycle de réservation. Les paramètres techniques détaillés sont confirmés dans le cadre de chaque intégration.

CANAUX DE DISTRIBUTIONInstitutions & services

BanqueAssuranceHôtellerieAssistance

CONTRAT D’INTÉGRATION COMMUN

API centrale Stratawise

Modèle canoniqueOrchestrationÉtats & erreursJournalisation

COUCHE D’ADAPTATIONConnecteurs loueurs

Partenaire MarocPartenaire internationalPartenaire internationalConnecteurs additionnels

CONTRAT CANONIQUE

Une requête commune en entrée. Une réponse normalisée en sortie.

Les adaptateurs partenaires traduisent les formats fournisseurs sans exposer leur diversité au système appelant. L’exemple ci-contre illustre la logique du contrat, pas un endpoint public figé.

REQUÊTE CANONIQUE

search
  pickup_station
  dropoff_station
  pickup_at
  dropoff_at
  driver_profile

API STRATAWISEValidation · adaptation · trace

RÉPONSE CANONIQUE

offers[]
  vehicle
  price
  conditions
  options
  provider_ref

CYCLE API

Le même vocabulaire suit la réservation de bout en bout.

Recherche, disponibilité, revalidation, réservation, confirmation et gestion après réservation restent cohérentes au niveau du modèle central.

RechercheCritères, station, dates

DisponibilitéOffres et conditions

RevalidationContrôle avant engagement

RéservationCréation partenaire

ConfirmationRéférence et voucher

Après réservationModifierAnnulerSuivre le statutRapprocher

PRINCIPES D’INTÉGRATION

Stabiliser ce que consomme le client, isoler ce qui varie chez les partenaires.

Objets canoniques. Stations, catégories, options, tarification, devis, réservation, voucher et états sont normalisés.

Reprises et doublons. Les opérations transactionnelles sont conçues pour être rejouables et traçables selon le périmètre d’intégration.

Erreurs exploitables. Les erreurs partenaires sont traduites dans une lecture cohérente tout en conservant la trace utile au diagnostic.

Versions maîtrisées. Les adaptateurs absorbent les variations fournisseurs pour limiter les ruptures du contrat central.

ATELIER TECHNIQUE

Partons du contrat et du scénario à prouver.

La documentation détaillée est alignée sur le partenaire, l’environnement et le périmètre réellement ouvert.

Cadrer l’intégration