Sono un integratore
Se ti stai avvicinando alle API GipoNext per la prima volta, qui trovi i concetti fondamentali da tenere a mente prima di iniziare lo sviluppo.
API REST
Le API GipoNext sono API REST e coprono un sottoinsieme delle funzionalità disponibili da interfaccia. Questa documentazione chiarisce fin dall'inizio il perimetro delle funzioni disponibili, così puoi allineare in modo realistico le aspettative del cliente rispetto al risultato che vuole ottenere.
Le API sono esposte in HTTPS con payload JSON, seguendo un modello diffuso nel mercato e supportato da tutti i principali linguaggi e framework. Questo ti permette di integrare rapidamente librerie, strumenti di test e pratiche già consolidate nel tuo team.
⚠️ Attenzione
Non sono disponibili webhook o altri canali di integrazione diversi dalle API REST.
OAuth
L'autenticazione e l'autorizzazione usano OAuth, uno standard di mercato per proteggere gli accessi alle API.
In termini pratici:
- non devi gestire password utente nella tua applicazione;
- lavori con token rilasciati in modo sicuro;
- l'accesso ai dati è legato al consenso e ai permessi dell'utente autenticato.
Per iniziare dal flusso giusto, vedi Flussi OAuth e token e Registrare l'applicazione.
Regole operative trasversali
Le API seguono regole tecniche comuni (paginazione, limiti di traffico, TLS, evoluzione non breaking). Per evitare errori tipici in produzione, consulta:
Dove proseguire
- Da dove iniziare per il percorso operativo completo;
- Flussi OAuth e token per i flussi supportati;
- Entità e operazioni per risorse, permessi e casi d'uso;
- Riferimento API per mappa endpoint e risorse.