API DeCA

Demonstração da API

Obtém um token público temporário e gera documentos de demonstração com dados fictícios.


Pedir um token demo

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

Envia um objeto JSON vazio para este endpoint público. Não é necessário um cabeçalho Bearer. A resposta 201 contém token e expires_at; a data de expiração é expressa em UTC.

Podes pedir um token sk_demo_ sem uma conta nem o registo de uma organização. Dura 24 horas a partir da emissão e funciona apenas a partir do IP público que o pediu. Mudar de rede ou de IP exige outro token.

Utiliza apenas dados fictícios. Todas as páginas do PDF apresentam SEM VALIDADE junto do logótipo e uma marca diagonal DEMO. Estes documentos não são válidos para transportar mercadorias nem para uso administrativo.

A demo aceita corpos até 32 KiB e dez documentos por sessão. A emissão de tokens permite três por minuto e dez por hora a partir do mesmo IP; a criação de documentos permite cinco por minuto e vinte por hora a partir do mesmo IP. Os limites partilhados por rede, região e carga global podem aplicar-se mais cedo. Estes valores correspondem à configuração predefinida. Envia document_locale para escolher o idioma de todos os PDF do token: es, ca, gl, ca-valencia, eu, en, pt-pt ou fr. Se for omitido, utiliza-se es. A resposta também inclui document_locale; para alterá-lo é necessário um novo token.

Pedir um token demo › Corpo do pedido

document_locale
​string · enum

Idioma dos PDF deste token. Espanhol por predefinição.

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

Pedir um token demo › Respostas

Token demo emitido; válido durante 24 horas e associado ao IP do pedido.

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

Podes pedir um token sk_demo_ sem uma conta nem o registo de uma organização. Dura 24 horas a partir da emissão e funciona apenas a partir do IP público que o pediu. Mudar de rede ou de IP exige outro token.

expires_at
​string · date-time · obrigatório

Data de expiração do token em UTC. Todos os seus documentos e ligações expiram neste instante.

document_locale
​string · enum · obrigatório

Idioma dos PDF deste token. Espanhol por predefinição.

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 diretamente no navegador através de /demo/d/{uuid}?k=..., sem Bearer. O documento e as suas ligações expiram com a sessão demo; criar ou retificar um documento não prolonga a duração do token.

Utiliza apenas dados fictícios. Todas as páginas do PDF apresentam SEM VALIDADE junto do logótipo e uma marca diagonal DEMO. Estes documentos não são válidos para transportar mercadorias nem para uso administrativo.

Abrir o PDF demo por QR › Parâmetros de caminho

uuid
​string · uuid · obrigatório

UUID público do documento; conhecê-lo não concede acesso.

Abrir o PDF demo por QR › Respostas

PDF original nativo, até 5 MB. Visualização no navegador sem regeneração.

string