Skip to content

Processo di Accreditamento API ​

Come attivare il servizio

Per sapere come attivare il servizio, rivolgiti al tuo Account Manager.

Questa pagina descrive cosa hai a disposizione una volta completata l'attivazione e come iniziare a operare sulle API.

In sintesi (TL;DR) ​

  1. Profilo sviluppatore: accedi con il tuo profilo su account.gipo.it. Con il ruolo Developer attivo vedi i menu di configurazione.
  2. App OAuth: nell'area Developer trovi la tua applicazione OAuth, con client_id e client_secret.
  3. Accesso ai dati: usa i dati del tuo client OAuth insieme alle credenziali di accesso su un tenant specifico per ottenere i token e operare sulle API.

Roadmap di Integrazione ​

Fase 1: Profilo sviluppatore ​

Il profilo sviluppatore è il punto di partenza per configurare l'integrazione.

  • Accesso: entra su account.gipo.it con il tuo account.
  • Ruolo Developer: con il ruolo attivo vedi i menu Developer. Se non li vedi, rivolgiti al tuo Account Manager.

Fase 2: Applicazione OAuth ​

Dal profilo sviluppatore gestisci la tua soluzione tecnica:

  1. Vai in Developer > OAuth Applications su account.gipo.it.
  2. Configurazione: qui trovi il nome dell'app, i Redirect URI (HTTPS) e gli scope abilitati (es. patients, agendas, medical reports).
  3. Gestione Ambienti:
    • Consigliato: usa due App distinte (es. "MiaApp - Test" e "MiaApp - Prod") per gestire separatamente client_secret e redirect differenti tra i tuoi ambienti di sviluppo e produzione.
    • Alternativa: puoi utilizzare una singola App se la tua architettura permette la gestione dinamica dei flussi su più ambienti.
  4. Credenziali: ogni app ha il proprio client_id e client_secret.

Fase 3: Accesso ai Dati (Operatività) ​

Per chiamare le API e accedere ai dati clinici serve un'utenza di accesso su un tenant.

  • Utenza del Centro Medico: il Centro Medico crea direttamente un'utenza tecnica dedicata all'integratore (es. integrazione.nome@centro.it) dal proprio gestionale, in Configurazione → Permessi → Utenti (www.giponext.it/utenti), scegliendo il ruolo più adatto all'integrazione (amministratore o medico, senza vincoli). Non serve aprire un ticket all'assistenza. Una volta creata, userai queste credenziali nel popup di login OAuth della tua applicazione per accedere ai dati reali del centro.

🛠️ Checklist Tecnica ​

  • [ ] Account attivo su account.gipo.it con ruolo Developer.
  • [ ] Redirect URI configurato correttamente (HTTPS).
  • [ ] Utenza di accesso creata dal Centro Medico.
  • [ ] client_id e client_secret a disposizione.

Risorse utili:Guida alla registrazione ➡️ | Dettagli flussi OAuth ➡️

🆘 Dubbi comuni ​

  • Perché non vedo i dati? Le credenziali dell'app (Fase 2) identificano il tuo software, ma l'accesso ai dati (Fase 3) richiede un'utenza valida del Centro Medico.
  • Posso cambiare i Redirect URI dopo? Sì. Puoi modificare la configurazione dell'app (inclusi i Redirect URI) in autonomia dal portale account.gipo.it, senza contattare l'assistenza. Alcune modifiche possono richiedere una nuova verifica prima di diventare effettive.
  • Le credenziali sono scadute? Ricorda che il client_secret va conservato in modo sicuro e non deve mai essere esposto in codice client-side (frontend).

Prossimi passi ​