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)
- Profilo sviluppatore: accedi con il tuo profilo su account.gipo.it. Con il ruolo Developer attivo vedi i menu di configurazione.
- App OAuth: nell'area Developer trovi la tua applicazione OAuth, con
client_ideclient_secret. - 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:
- Vai in Developer > OAuth Applications su account.gipo.it.
- Configurazione: qui trovi il nome dell'app, i Redirect URI (HTTPS) e gli scope abilitati (es.
patients,agendas,medical reports). - Gestione Ambienti:
- Consigliato: usa due App distinte (es. "MiaApp - Test" e "MiaApp - Prod") per gestire separatamente
client_secrete 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.
- Consigliato: usa due App distinte (es. "MiaApp - Test" e "MiaApp - Prod") per gestire separatamente
- Credenziali: ogni app ha il proprio
client_ideclient_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.itcon ruolo Developer. - [ ] Redirect URI configurato correttamente (HTTPS).
- [ ] Utenza di accesso creata dal Centro Medico.
- [ ]
client_ideclient_secreta 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_secretva conservato in modo sicuro e non deve mai essere esposto in codice client-side (frontend).
Prossimi passi
- Da dove iniziare — panoramica completa dell'integrazione
- Registrare l'applicazione — configurazione dettagliata dell'applicazione
- Flussi OAuth e token — flussi tecnici e gestione token