API DeCA

API para emitir, rectificar, consultar e descargar documentos españois de control administrativo do transporte de mercadorías. Para obter un token, contacta co soporte de SERTEC PESAGE. Os tokens sk_test_ usan desenvolvemento e os sk_live_ produción, con datos separados. A restrición por IP é opcional.

Cada credencial permite consultar e descargar os seus documentos durante as 24 horas seguintes á creación. A descarga por QR ten unha vixencia independente. As rectificacións conservan o documento orixinal.

O borrado lóxico só se permite durante as primeiras 2 horas para corrixir erros de xeración. A integración debe confirmar que o documento non se entregou ao transportista nin se utilizou no transporte. Consérvanse o ficheiro e a rastrexabilidade, pero bloquéase o acceso.

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 engade demo: true, expires_at, qr_url (alias de url) e pdf_url (alias de pdf_download_url). document_locale é o idioma escollido ao solicitar o token (es por defecto). Os datos e PDF temporais están separados do arquivo real e non se cifran como os documentos reais. 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.

Esquemas de seguridade
bearerAuth
Token de integración facilitado polo soporte de SERTEC PESAGE. Envíao en Authorization: Bearer, exclusivamente mediante HTTPS. sk_test_ selecciona desenvolvemento e sk_live_ produción. Se o token ten unha lista de IP autorizadas, a petición debe proceder dunha delas; unha lista baleira permite calquera IP. Non envíes o token na URL nin o expoñas en aplicacións cliente. 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.
http
qrSecret
Segredo opaco da ligazón QR; copia exactamente o valor devolto en url.
apiKey