API DeCA

API demonstration

Get a temporary public token and generate demonstration documents using fictitious data.


Request a demo token

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

Send an empty JSON object to this public endpoint. No Bearer header is required. The 201 response contains token and expires_at; the expiry time is expressed in UTC.

You can request an sk_demo_ token without an account or a registered organisation. It lasts 24 hours from issuance and works only from the public IP that requested it. Changing network or IP requires another token.

Use fictitious data only. Every PDF page displays NOT VALID beside the logo and a diagonal DEMO watermark. These documents are not valid for transporting goods or for administrative use.

The demo accepts bodies up to 32 KiB and ten documents per session. Token issuance allows three per minute and ten per hour from the same IP; document creation allows five per minute and twenty per hour from the same IP. Shared network, region and global load limits may apply earlier. These figures describe the default configuration. Send document_locale to choose the language of every PDF for this token: es, ca, gl, ca-valencia, eu, en, pt-pt or fr. If omitted, es is used. The response also includes document_locale; changing it requires a new token.

Request a demo token › Request Body

document_locale
​string · enum

Language of this token’s PDFs. Spanish by default.

Enum values:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr
Default: es

Request a demo token › Responses

Demo token issued; valid for 24 hours and bound to the requesting IP.

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

You can request an sk_demo_ token without an account or a registered organisation. It lasts 24 hours from issuance and works only from the public IP that requested it. Changing network or IP requires another token.

expires_at
​string · date-time · required

Token expiry time in UTC. All its documents and links expire at this instant.

document_locale
​string · enum · required

Language of this token’s PDFs. Spanish by default.

Enum values:
es
ca
gl
ca-valencia
eu
en
pt-pt
fr

Open the demo PDF by QR

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

The QR opens the PDF directly in the browser through /demo/d/{uuid}?k=..., without Bearer authentication. The document and its links expire with the demo session; creating or rectifying a document does not extend the token’s lifetime.

Use fictitious data only. Every PDF page displays NOT VALID beside the logo and a diagonal DEMO watermark. These documents are not valid for transporting goods or for administrative use.

Open the demo PDF by QR › Path parameters

uuid
​string · uuid · required

Public document UUID; knowing it does not grant access.

Open the demo PDF by QR › Responses

Original native PDF, up to 5 MB. Browser viewing without regeneration.

string