API REST · Documentación para desarrolladores

Integra la infraestructura
en 5 minutos.

API REST completa, documentación interactiva, alojamiento soberano en la UE. Nosotros nos ocupamos de la complejidad normativa: tú te centras en tu producto.

REST · JSON
OAuth 2.0
Alojado en la UE
Inicio rápido

Operativo en 3 pasos.

De cero a tu primer ticket emitido en producción.

1
Obtén tus credenciales

Limpidius aprovisiona una cuenta de servicio al abrir tu acceso. Recibirás un client_id y un client_secret asociados a tu tenant y a tu entorno.

2
Autentícate

Intercambia tus credenciales por un Bearer token a través del servidor de autorización OAuth 2.0. El token es válido durante el tiempo indicado: guárdalo en caché.

3
Emite tu primer ticket

Envía una transacción estructurada a la API de Platon. La API gestiona la entrega, la generación de la factura y el formato del ticket: en una sola llamada.

cURL
 
# Obtener 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}'

# Usar el token para llamar a la API
curl --request POST \
  '{BASE_URL}/platon/transactions' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '{ ... }'
Referencia de la API

Los endpoints disponibles.

API REST · Autenticación OAuth 2.0 · Alojamiento soberano en la UE

POST
/platon/transactions
Emite un ticket digital estructurado a partir de una transacción de TPV. Entrega por correo o impresión, datos de producto, IVA y pago con tarjeta.
Leer la documentación
Ecosistema

Otras API y webhooks.

Platon es solo un punto de entrada entre varios. El resto de la infraestructura también se integra mediante API.

API de Socrate

Flujo de impresión: transmite las órdenes destinadas a la impresora térmica.

Más información →
API de Nestor

Archivo y exposición de los tickets: WebArchive, WebReceipt, PDF.

Más información →
API de Homer

Identificación de clientes y portal de consentimiento RGPD.

Más información →
Especificaciones técnicas

Una API diseñada para producción.

Latencia
<100ms
Región UE-Oeste
Uptime
99.9%
En producción
Datos
🇪🇺 EU
Alojamiento soberano

Toda la documentación, lista para usar.

Referencia completa de endpoints, esquemas de datos, autenticación y webhooks.