Skip to content

Da dove iniziare ​

Come attivare il servizio

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

Questa guida serve a impostare un'integrazione efficace fin dall'inizio: aspettative allineate, responsabilità chiare e nessuna sorpresa. Non serve esperienza pregressa con OAuth: i concetti sono introdotti passo dopo passo.

I 3 attori di un'integrazione ​

Ogni integrazione coinvolge tre parti con ruoli distinti:

ChiCosa fa
GipoNextFornisce le API e la documentazione
System Integrator (tu)Sviluppa, testa e mantiene l'integrazione
Centro medico (il tuo cliente)Definisce gli obiettivi e autorizza l'accesso ai propri dati

💡 Responsabilità chiave

GipoNext fornisce piattaforma e supporto mirato. Il progetto di integrazione (sviluppo, test, go-live, manutenzione) è interamente in carico all'integratore.

Due identità separate: app e utente ​

Per accedere alle API servono due cose distinte:

IdentitàCos'èDove si trova
Applicazione (client_id + client_secret)Identifica il tuo softwareArea Developer su account.gipo.it
Utente (login interattivo)Determina tenant e permessiLogin dell'utente finale su account.gipo.it

Le credenziali dell'applicazione non danno accesso ai dati: servono solo a identificare il software. L'accesso ai dati dipende sempre dall'utente che fa il login.

Per capire a fondo questa separazione e perché è importante, vedi Credenziali sviluppatore e credenziali di accesso al sistema.

Cosa fare in pratica ​

Passo 1 — Recuperare le credenziali ​

Una volta attivato, hai a disposizione il profilo sviluppatore e le credenziali della tua applicazione OAuth (client_id e client_secret).

Cosa hai a disposizione e come usarlo è descritto nella pagina Processo di accreditamento.

Passo 2 — Implementare OAuth ​

Usa uno dei flussi supportati:

  • Authorization Code (raccomandato) — per app con browser o interfaccia completa (web, desktop, mobile).
  • Device Code — per dispositivi senza browser (l'utente autorizza da un altro dispositivo).

Dettagli: Flussi OAuth e token.

Passo 3 — Chiamare le API ​

  • Base URL: https://api.giponext.it/v2/tenants/{tenantId}/...
  • Recupera tenantId dall'endpoint UserInfo dopo l'autenticazione.
  • Includi il Bearer token nell'header Authorization di ogni richiesta.
http
GET https://api.giponext.it/v2/tenants/{tenantId}/patients
Authorization: Bearer <access_token>
Accept: application/json

Per l'elenco completo di endpoint e modelli dati: Swagger UI e Riferimento API.

Prossimi passi ​