Menu de la documentation
Vue d’ensemble Dernière mise à jour: 20 octobre 2026

Démarrer une intégration

Préparez, sécurisez, testez et lancez une intégration technologique avec Parkour Design.

Parkour Design peut se connecter à des logiciels de gestion de concours, à des plateformes qui gèrent des événements et des épreuves, à des circuits documentaires et à d’autres outils utilisés par les organisateurs et les chefs de piste. Une intégration peut transférer des données et des documents de façon sécurisée entre systèmes, sans ressaisie manuelle ni envoi de fichiers en dehors du circuit habituel.

S’appuyer sur des standards établis comme OAuth 2.0 et OpenID Connect rend la mise en œuvre prévisible et sûre, sans que le partenaire ait à construire tout le mécanisme d’autorisation de zéro. Le périmètre final est adapté au système du partenaire et au parcours utilisateur validé.

Vous voulez d’abord voir le fonctionnement côté produit ? Consultez Plans de parcours CSO pour plateformes équestres pour le flux de publication proposé et la limite entre les fonctions actuelles et le travail propre à chaque partenaire.

Avantages d’une intégration

Une intégration bien conçue peut apporter :

  • un transfert plus rapide des plans de parcours et des données d’épreuve ;
  • moins de saisie manuelle et moins d’erreurs évitables ;
  • un fonctionnement cohérent pour l’utilisateur ;
  • un accès sécurisé sans partage des mots de passe des comptes ;
  • la compatibilité avec les outils et processus existants du partenaire ;
  • le contrôle par l’utilisateur de l’accès à ses données.

Parkour Design prend en charge les intégrations dans deux sens. Parkour Design peut se connecter au fournisseur d’identité et à l’API d’un partenaire, ou un partenaire peut se connecter aux services d’identité et de données de Parkour Design. Ces deux sens sont conçus et validés séparément, même quand un produit a besoin des deux.

Cette page décrit le démarrage d’une intégration. Ce n’est ni un enregistrement de client en libre-service ni une référence complète de l’API. Contactez Parkour Design avant de développer contre un service de production.

Poursuivez avec les documents de mise en œuvre :

  • Authentification pour l’enregistrement, le code d’autorisation, la validation des jetons et la rotation des jetons de rafraîchissement ;
  • Échange de données pour les ressources actuelles, les schémas, les limites et les exports propres à chaque partenaire ;
  • Tests et mise en production pour les contrôles exécutables, les scénarios de recette et la validation de la mise en production.

Choisir le sens de l’intégration

Parkour Design se connecte au partenaire

Utilisez ce sens quand un utilisateur de Parkour Design doit envoyer un plan de parcours vers un système partenaire ou choisir une destination gérée par ce partenaire.

  1. L’utilisateur connecté lance la connexion dans Parkour Design.
  2. Le serveur de Parkour Design crée une transaction d’autorisation de courte durée.
  3. Le navigateur ouvre le point de terminaison d’autorisation du partenaire.
  4. Le partenaire renvoie un code d’autorisation à l’URL de rappel enregistrée de Parkour Design.
  5. Le serveur de Parkour Design échange et valide le code.
  6. Parkour Design conserve le jeton d’accès du partenaire sur le serveur, jamais dans le stockage du navigateur.
  7. Parkour Design appelle l’API convenue du partenaire au nom de cet utilisateur.

Le partenaire fournit ses métadonnées OpenID Connect ou OAuth, l’enregistrement du client, les attributs d’identité, le contrat d’API et un environnement de test.

Le partenaire se connecte à Parkour Design

Utilisez ce sens quand une application partenaire a besoin que l’utilisateur de Parkour Design lui donne accès à ses données Parkour Design.

  1. Le partenaire redirige l’utilisateur vers le point de terminaison d’autorisation de Parkour Design.
  2. Parkour Design authentifie l’utilisateur et lui demande son consentement.
  3. Parkour Design renvoie un code d’autorisation de courte durée à l’URL de rappel enregistrée du partenaire.
  4. Le serveur du partenaire échange le code contre des jetons.
  5. Le partenaire valide l’identité renvoyée et n’utilise le jeton d’accès que pour les ressources Parkour Design autorisées.

Parkour Design exploite actuellement un fournisseur OIDC à code d’autorisation et un service de ressources limité à l’utilisateur. L’enregistrement des clients et l’accès en production se coordonnent avec Parkour Design.

Démarche et environnements

Commencez par un court échange technique de cadrage. Chaque équipe désigne un responsable technique et un contact opérationnel.

Préparez une note technique couvrant :

  • le sens de l’intégration et le résultat attendu pour l’utilisateur ;
  • les environnements de test et de production, avec les URI de redirection exactes ;
  • la méthode d’authentification, les attributs d’identité requis et les autorisations validées ;
  • les données échangées, les ressources demandées et la source de référence ;
  • le volume attendu, les limites et les exigences de fiabilité ;
  • les responsables techniques, sécurité, support et lancement.

N’envoyez jamais de secrets de production dans des tickets, des messages de chat, des fichiers sources, des captures d’écran ou une documentation publique. Convenez d’un canal sécurisé pour les identifiants et d’une procédure de rotation avant leur émission.

Démarrer une intégration

Envoyez la note technique à Parkour Design pour lancer l’examen.

L’enregistrement des clients, les identifiants, les scopes et l’accès en production ne sont fournis qu’après une revue technique et de sécurité.