API DeCA

Demostración da API

Obtén un token público temporal e xera documentos de demostración con datos ficticios.


Solicitar un token demo

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

Envía un obxecto JSON baleiro a este endpoint público. Non precisa unha cabeceira Bearer. A resposta 201 contén token e expires_at; a data de caducidade exprésase en UTC.

Podes solicitar un token sk_demo_ sen conta nin alta dunha organización. Dura 24 horas desde a súa emisión e só funciona desde a IP pública que o solicitou. Cambiar de rede ou de IP require solicitar outro token.

Utiliza unicamente datos ficticios. Cada páxina do PDF mostra SEN VALIDEZ xunto ao logo e unha marca diagonal DEMO. Estes documentos non serven para transportar mercadorías nin como documentos administrativos válidos.

A demo admite corpos de ata 32 KiB e dez documentos por sesión. A emisión de tokens admite tres por minuto e dez por hora desde unha mesma IP; a creación, cinco por minuto e vinte por hora desde unha mesma IP. Os límites compartidos por rede, rexión e carga global poden aplicarse antes. Estas cifras corresponden á configuración predeterminada. Podes enviar document_locale para escoller o idioma de todos os PDF do token: es, ca, gl, ca-valencia, eu, en, pt-pt ou fr. Se se omite, utilízase es. A resposta tamén inclúe document_locale; cambialo require un novo token.

Solicitar un token demo › Corpo da petición

document_locale
​string · enum

Idioma dos PDF deste token. Castelán por defecto.

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

Solicitar un token demo › Respostas

Token demo emitido; válido durante 24 horas e vinculado á IP solicitante.

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

Podes solicitar un token sk_demo_ sen conta nin alta dunha organización. Dura 24 horas desde a súa emisión e só funciona desde a IP pública que o solicitou. Cambiar de rede ou de IP require solicitar outro token.

expires_at
​string · date-time · obrigatorio

Caducidade do token en UTC. Todos os seus documentos e ligazóns vencen neste instante.

document_locale
​string · enum · obrigatorio

Idioma dos PDF deste token. Castelán por defecto.

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

Abrir o PDF demo por QR

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

O QR abre o PDF directamente no navegador mediante /demo/d/{uuid}?k=..., sen Bearer. Tanto o documento como as súas ligazóns caducan coa sesión demo; crear ou rectificar un documento non amplía a duración do token.

Utiliza unicamente datos ficticios. Cada páxina do PDF mostra SEN VALIDEZ xunto ao logo e unha marca diagonal DEMO. Estes documentos non serven para transportar mercadorías nin como documentos administrativos válidos.

Abrir o PDF demo por QR › Parámetros de ruta

uuid
​string · uuid · obrigatorio

UUID público do documento; coñecelo non concede acceso.

Abrir o PDF demo por QR › Respostas

PDF orixinal nativo, de ata 5 MB. Visualización no navegador sen rexeneración.

string