API DeCA

Demostración de la API

Consigue un token público temporal y genera documentos de demostración con datos ficticios.


Solicitar token demo

POST
https://deca.sertecpesage.com
/api/v1/demo/tokens

Envía un objeto JSON vacío a este endpoint público. No necesita una cabecera Bearer. La respuesta 201 contiene token y expires_at; la fecha de caducidad se expresa en UTC.

Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token.

Utiliza únicamente datos ficticios. Cada página del PDF muestra SIN VALIDEZ junto al logo y una marca diagonal DEMO. Estos documentos no sirven para transportar mercancías ni como documentos administrativos válidos.

La demo admite cuerpos de hasta 32 KiB y diez documentos por sesión. La emisión de tokens admite tres por minuto y diez por hora desde una misma IP; la creación, cinco por minuto y veinte por hora desde una misma IP. Los límites compartidos por red, región y carga global pueden aplicarse antes. Estas cifras corresponden a la configuración predeterminada. Puedes enviar document_locale para elegir el idioma de todos los PDF del token: es, ca, gl, ca-valencia, eu, en, pt-pt o fr. Si se omite, se utiliza es. La respuesta también incluye document_locale; cambiarlo requiere un nuevo token.

Solicitar token demo › Cuerpo de la petición

document_locale
​string · enum

Idioma de los PDF de este token. Español por defecto.

Valores admitidos:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr
Valor por defecto: es

Solicitar token demo › Respuestas

Token demo emitido; válido durante 24 horas y vinculado a la IP solicitante.

token
​string · pattern: ^sk_demo_[0-9a-f]{64… · obligatorio

Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token.

expires_at
​string · date-time · obligatorio

Caducidad del token en UTC. Todos sus documentos y enlaces vencen en este instante.

document_locale
​string · enum · obligatorio

Idioma de los PDF de este token. Español por defecto.

Valores admitidos:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr

Abrir PDF demo por QR

GET
https://deca.sertecpesage.com
/demo/d/{uuid}
k (query)

El QR abre el PDF directamente en el navegador mediante /demo/d/{uuid}?k=..., sin Bearer. Tanto el documento como sus enlaces caducan con la sesión demo; crear o rectificar un documento no amplía la duración del token.

Utiliza únicamente datos ficticios. Cada página del PDF muestra SIN VALIDEZ junto al logo y una marca diagonal DEMO. Estos documentos no sirven para transportar mercancías ni como documentos administrativos válidos.

Abrir PDF demo por QR › Parámetros de ruta

uuid
​string · uuid · obligatorio

UUID público del documento; conocerlo no concede acceso.

Abrir PDF demo por QR › Respuestas

PDF original nativo, de hasta 5 MB. Visualización en el navegador sin regeneración.

string