API REST · Documentazione per Sviluppatori

Integra l'infrastruttura
in 5 minuti.

API REST completa, documentazione interattiva, hosting sovrano UE. Ci occupiamo noi della complessità normativa: tu ti concentri sul tuo prodotto.

REST · JSON
OAuth 2.0
Hosting UE
Guida rapida

Operativo in 3 passaggi.

Da zero al tuo primo scontrino emesso in produzione.

1
Ottieni le tue credenziali

Un account di servizio viene attivato da Limpidius all'apertura del tuo accesso. Riceverai un client_id e un client_secret associati al tuo tenant e al tuo ambiente.

2
Autenticati

Scambia le tue credenziali con un Bearer token tramite il server di autorizzazione OAuth 2.0. Il token è valido per la durata indicata: mettilo in cache.

3
Emetti il tuo primo scontrino

Invia una transazione strutturata all'API Platon. L'API gestisce la consegna, la generazione della fattura e la formattazione dello scontrino: in un'unica chiamata.

cURL
 
# Ottieni un Bearer token
curl --request POST \
  'https://accounts.limpidius.com/auth/realms/limpidius/protocol/openid-connect/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id={YOUR_CLIENT_ID}' \
  --data-urlencode 'client_secret={YOUR_CLIENT_SECRET}'

# Usa il token per chiamare l'API
curl --request POST \
  '{BASE_URL}/platon/transactions' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '{ ... }'
Riferimento API

Gli endpoint disponibili.

API REST · Autenticazione OAuth 2.0 · Hosting sovrano UE

POST
/platon/transactions
Emetti uno scontrino digitale strutturato a partire da una transazione POS. Consegna via email o stampa, dati prodotto, IVA e pagamento con carta.
Leggi la documentazione
Ecosistema

Altre API e webhook.

Platon è solo uno dei punti di accesso. Il resto dell'infrastruttura si integra anch'esso tramite API.

API Socrate

Flusso di stampa: trasmetti gli ordini destinati alla stampante termica.

Scopri di più →
API Nestor

Archiviazione ed esposizione degli scontrini: WebArchive, WebReceipt, PDF.

Scopri di più →
API Homer

Identificazione cliente e portale di consenso GDPR.

Scopri di più →
Specifiche tecniche

Un'API progettata per la produzione.

Latenza
<100ms
Regione UE-Ovest
Uptime
99.9%
In produzione
Dati
🇪🇺 EU
Hosting sovrano

Tutta la documentazione, pronta all'uso.

Riferimento completo di endpoint, schemi dati, autenticazione e webhook.