API DeCA

Demostració de l’API

Obtin un token públic temporal i genera documents de demostració amb dades fictícies.


Sol·licitar un token demo

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

Envia un objecte JSON buit a este endpoint públic. No necessita cap capçalera Bearer. La resposta 201 conté token i expires_at; la data de caducitat s’expressa en UTC.

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. Estos documents no servixen per a transportar mercaderies ni com a documents administratius vàlids.

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. Estes xifres corresponen a la configuració predeterminada. Pots enviar document_locale per triar l’idioma de tots els PDF del token: es, ca, gl, ca-valencia, eu, en, pt-pt o fr. Si s’omet, s’utilitza es. La resposta també inclou document_locale; canviar-lo requerix un token nou.

Sol·licitar un token demo › Cos de la petició

document_locale
​string · enum

Idioma dels PDF d’este token. Castellà per defecte.

Valors admesos:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr
Valor per defecte: es

Sol·licitar un token demo › Respostes

Token demo emés; vàlid durant 24 hores i vinculat a la IP sol·licitant.

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

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.

expires_at
​string · date-time · obligatori

Caducitat del token en UTC. Tots els seus documents i enllaços vencen en este instant.

document_locale
​string · enum · obligatori

Idioma dels PDF d’este token. Castellà per defecte.

Valors admesos:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr

Obrir el PDF demo per QR

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

El QR obri el PDF directament en el navegador mitjançant /demo/d/{uuid}?k=..., sense Bearer. Tant el document com els enllaços caduquen amb la sessió demo; crear o rectificar un document no allarga la durada del token.

Utilitza només dades fictícies. Cada pàgina del PDF mostra SENSE VALIDESA al costat del logo i una marca diagonal DEMO. Estos documents no servixen per a transportar mercaderies ni com a documents administratius vàlids.

Obrir el PDF demo per QR › Paràmetres de ruta

uuid
​string · uuid · obligatori

UUID públic del document; conèixer-lo no concedeix accés.

Obrir el PDF demo per QR › Respostes

PDF original natiu, de fins a 5 MB. Visualització al navegador sense regeneració.

string