Menu della documentazione
Panoramica Ultimo aggiornamento: 20 ottobre 2026

Avviare un’integrazione

Pianifica, proteggi, testa e lancia un’integrazione tecnica con Parkour Design.

Parkour Design si può collegare a sistemi di gestione dei concorsi, piattaforme che gestiscono eventi e categorie, flussi documentali e altri strumenti usati da comitati organizzatori e direttori di campo. Un’integrazione può trasferire in sicurezza dati e documenti tra sistemi, senza reinserire a mano le informazioni o inviare file fuori dal normale flusso di lavoro.

Con standard consolidati come OAuth 2.0 e OpenID Connect l’implementazione è prevedibile e sicura, senza che il partner debba costruire da zero l’intero meccanismo di autorizzazione. L’ambito finale si adatta al sistema del partner e al percorso utente approvato.

Vuoi vedere prima il flusso di lavoro nel prodotto? Il flusso di pubblicazione proposto e il confine tra le funzioni attuali e il lavoro specifico per il partner sono descritti in Grafici dei percorsi per piattaforme equestri.

Vantaggi di un’integrazione

Un’integrazione ben progettata può offrire:

  • un passaggio più rapido dei grafici dei percorsi e dei dati delle categorie;
  • meno inserimenti manuali e meno errori evitabili;
  • un flusso di lavoro uniforme per l’utente;
  • un accesso sicuro senza condividere le password degli account;
  • compatibilità con gli strumenti e i processi esistenti del partner;
  • il controllo dell’utente sull’accesso ai propri dati.

Parkour Design supporta integrazioni tecniche in due direzioni. Parkour Design può collegarsi al provider di identità e all’API del partner, oppure il partner può collegarsi ai servizi di identità e dati di Parkour Design. Le direzioni si progettano e si approvano separatamente, anche quando un prodotto ha bisogno di entrambe.

Questa pagina descrive il processo di onboarding. Non è una registrazione self-service dei client né un riferimento completo dell’API. Contatta Parkour Design prima di sviluppare contro un servizio di produzione.

Prosegui con la documentazione di implementazione:

  • Autenticazione: registrazione, codice di autorizzazione, verifica dei token e rotazione al rinnovo;
  • Scambio di dati: risorse attuali, schemi, limiti ed esportazioni specifiche per il partner;
  • Test e lancio: controlli eseguibili, scenari di accettazione e approvazione per la produzione.

Scegli la direzione dell’integrazione

Parkour Design si collega al partner

Usa questa direzione quando un utente in Parkour Design deve inviare un grafico del percorso a un sistema del partner o scegliere una destinazione gestita dal partner.

  1. L’utente autenticato avvia il collegamento in Parkour Design.
  2. Il backend di Parkour Design crea una transazione di autorizzazione di breve durata.
  3. Il browser apre l’endpoint di autorizzazione del partner.
  4. Il partner restituisce un codice di autorizzazione al callback registrato di Parkour Design.
  5. Il backend di Parkour Design scambia e verifica il codice.
  6. Parkour Design conserva il token di accesso del partner sul server, mai nella memoria del browser.
  7. Parkour Design chiama l’API concordata del partner per conto dell’utente.

Il partner fornisce i metadati OpenID Connect o OAuth, la registrazione del client, i claim di identità, il contratto API e l’ambiente di test.

Il partner si collega a Parkour Design

Usa questa direzione quando un’applicazione del partner ha bisogno che l’utente di Parkour Design conceda l’accesso ai dati in Parkour Design.

  1. Il partner reindirizza l’utente all’endpoint di autorizzazione di Parkour Design.
  2. Parkour Design autentica l’utente e chiede il consenso.
  3. Parkour Design restituisce un codice di autorizzazione di breve durata al callback registrato del partner.
  4. Il backend del partner scambia il codice con i token.
  5. Il partner verifica l’identità restituita e usa il token di accesso solo per le risorse approvate di Parkour Design.

Parkour Design gestisce attualmente un provider OIDC con codice di autorizzazione e un servizio di risorse limitato all’utente. Registrazione dei client e accesso alla produzione si coordinano con Parkour Design.

Collaborazione e ambienti

Inizia con una breve analisi tecnica. Entrambi i team indicano un responsabile tecnico e un referente operativo.

Prepara una descrizione tecnica che comprenda:

  • direzione dell’integrazione e risultato atteso per l’utente;
  • ambienti di test e di produzione, compresi gli URI di reindirizzamento esatti;
  • metodo di autenticazione, claim di identità necessari e autorizzazioni approvate;
  • dati scambiati, risorse richieste e quale fonte è autorevole;
  • volume previsto, limiti e requisiti di affidabilità;
  • responsabili di tecnica, sicurezza, assistenza e lancio.

Non inviare mai segreti di produzione in ticket, messaggi di chat, file sorgente, screenshot o documentazione pubblica. Prima del rilascio delle credenziali, concordate un canale sicuro e una procedura di rotazione.

Avviare un’integrazione

Per avviare la revisione, invia la descrizione tecnica a Parkour Design.

Registrazione del client, credenziali, scope e accesso alla produzione vengono concessi solo dopo una revisione tecnica e di sicurezza.