Skip to content

Getting started ​

How to activate the service

To find out how to activate the service, please contact your Account Manager.

This guide helps you set up an effective integration from the start: aligned expectations, clear responsibilities, and no surprises. No prior OAuth experience is required; concepts are introduced step by step.

The 3 actors in an integration ​

Every integration involves three distinct roles:

WhoRole
GipoNextProvides the APIs and the documentation
System Integrator (you)Develops, tests, and maintains the integration
Medical centre (your client)Defines objectives and authorizes access to its data

πŸ’‘ Key responsibilities

GipoNext provides platform and targeted support. The integration project (development, testing, go-live, maintenance) is entirely the integrator's responsibility.

Two separate identities: app and user ​

API access requires two distinct things:

IdentityWhat it isWhere to find it
Application (client_id + client_secret)Identifies your softwareDeveloper area on account.gipo.it
User (interactive login)Determines tenant and permissionsEnd-user login on account.gipo.it

Application credentials do not grant data access; they only identify the software. Data access always depends on the user who logs in.

For a deeper understanding of this separation and why it matters, see OAuth flows and tokens.

What to do in practice ​

Step 1 β€” Get your credentials ​

Once activated, you have a developer profile and the credentials of your OAuth application (client_id and client_secret).

What you get and how to use it is described in Accreditation process.

Step 2 β€” Implement OAuth ​

Use one of the supported flows:

  • Authorization Code (recommended) β€” for apps with browser or full UI (web, desktop, mobile).
  • Device Code β€” for devices without a browser (user authorizes from another device).

Details: OAuth flows and tokens.

Step 3 β€” Call the APIs ​

  • Base URL: https://api.giponext.it/v2/tenants/{tenantId}/...
  • Get tenantId from the UserInfo endpoint after authentication.
  • Include the Bearer token in the Authorization header of every request.
http
GET https://api.giponext.it/v2/tenants/{tenantId}/patients
Authorization: Bearer <access_token>
Accept: application/json

For the full list of endpoints and data models: Swagger UI and API reference.

Next steps ​