API DeCA

API per emetre, rectificar, consultar i descarregar documents espanyols de control administratiu del transport de mercaderies. Per obtenir un token, contacta amb el suport de SERTEC PESAGE. Els tokens sk_test_ utilitzen desenvolupament i els sk_live_ producció, amb dades separades. La restricció per IP és opcional.

Cada credencial permet consultar i descarregar els seus documents durant les 24 hores següents a la creació. La descàrrega per QR té una vigència independent. Les rectificacions conserven el document original.

L'esborrament lògic només es permet durant les primeres 2 hores per corregir errors de generació. La integració ha de confirmar que el document no s'ha lliurat al transportista ni utilitzat en el transport. Es conserven l'arxiu i la traçabilitat, però se'n bloqueja l'accés.

Pots sol·licitar un token sk_demo_ sense compte ni alta d’una organització. Dura 24 hores des de l’emissió i només funciona des de la IP pública que l’ha sol·licitat. Si canvies de xarxa o d’IP, cal sol·licitar un altre token. Utilitza només dades fictícies. Cada pàgina del PDF mostra SENSE VALIDESA al costat del logo i una marca diagonal DEMO. Aquests documents no serveixen per transportar mercaderies ni com a documents administratius vàlids. La demo afegeix demo: true, expires_at, qr_url (àlies de url) i pdf_url (àlies de pdf_download_url). document_locale és l’idioma triat en sol·licitar el token (es per defecte). Les dades i PDF temporals estan separats de l’arxiu real i no es xifren com els documents reals. La demo admet cossos de fins a 32 KiB i deu documents per sessió. L’emissió de tokens admet tres per minut i deu per hora des d’una mateixa IP; la creació, cinc per minut i vint per hora des d’una mateixa IP. Els límits compartits per xarxa, regió i càrrega global es poden aplicar abans. Aquestes xifres corresponen a la configuració predeterminada.

Esquemes de seguretat
bearerAuth
Token d'integració facilitat pel suport de SERTEC PESAGE. Envia'l a Authorization: Bearer, exclusivament mitjançant HTTPS. sk_test_ selecciona desenvolupament i sk_live_ producció. Si el token té una llista d'IP autoritzades, la petició ha de procedir d'una d'aquestes; una llista buida permet qualsevol IP. No enviïs el token a la URL ni l'exposis en aplicacions client. Pots sol·licitar un token sk_demo_ sense compte ni alta d’una organització. Dura 24 hores des de l’emissió i només funciona des de la IP pública que l’ha sol·licitat. Si canvies de xarxa o d’IP, cal sol·licitar un altre token. Utilitza només dades fictícies. Cada pàgina del PDF mostra SENSE VALIDESA al costat del logo i una marca diagonal DEMO. Aquests documents no serveixen per transportar mercaderies ni com a documents administratius vàlids.
http
qrSecret
Secret opac de l'enllaç QR; copia exactament el valor retornat a url.
apiKey