Probar la API con un token demo
Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token.
Utiliza únicamente datos ficticios. Cada página del PDF muestra SIN VALIDEZ junto al logo y una marca diagonal DEMO. Estos documentos no sirven para transportar mercancías ni como documentos administrativos válidos.
1. Solicitar el token
Envía un objeto JSON vacío a este endpoint público. No necesita una cabecera Bearer. La respuesta 201 contiene token y expires_at; la fecha de caducidad se expresa en UTC.
Puedes incluir document_locale al solicitar el token: es, ca, gl, ca-valencia, eu, en, pt-pt o fr. Por ejemplo, {"document_locale":"en"} genera sus PDF en inglés. Sin este campo se utiliza es. La respuesta incluye el idioma elegido; para cambiarlo solicita un token nuevo.
Código
Código
2. Emitir un documento de ejemplo
Guarda este JSON como document.json. La demostración utiliza las mismas rutas y campos del contrato habitual, y valida los datos de transporte. Los nombres, direcciones y referencias del ejemplo son ficticios.
Código
Envía la petición desde la misma IP, sustituyendo YOUR_DEMO_TOKEN por el token recibido:
Código
La respuesta contiene uuid, url, qr, pdf_download_url, normalized_data, metadata, rectifies_uuid y document_locale, como en la API habitual. En la demo añade expires_at, qr_url y pdf_url. Guarda el UUID y utiliza las URL recibidas.
Solo en la demo se devuelve también demo: true; el PDF utiliza el document_locale elegido al solicitar el token, por defecto es. qr_url es un alias de url y pdf_url de pdf_download_url.
3. Consultar y abrir el PDF
Puedes listar, consultar, rectificar y eliminar documentos mediante las operaciones de la referencia API. Las llamadas Bearer siguen exigiendo el mismo token y la misma IP. Para consultar el documento:
Código
El QR abre el PDF directamente en el navegador mediante /demo/d/{uuid}?k=..., sin Bearer. Tanto el documento como sus enlaces caducan con la sesión demo; crear o rectificar un documento no amplía la duración del token.
Un token demo vencido o enviado desde otra IP devuelve 401. Un QR demo vencido devuelve 404. Si la demo está desactivada, devuelve 503 DEMO_UNAVAILABLE. El primer acceso al QR o una rectificación impiden eliminar el documento; se mantienen las confirmaciones de borrado del contrato habitual.
Caducidad, límites y privacidad
La demo tiene su propio almacenamiento temporal, separado de usuarios, organizaciones y documentos reales. Sus datos y PDF no tienen las garantías de cifrado ni los plazos de conservación del archivo real. No envíes datos personales, secretos ni documentos de transportes reales.
El token, sus documentos y sus enlaces caducan a las 24 horas desde la emisión del token; el borrado del almacenamiento activo se ejecuta periódicamente. Las copias de Hostinger de los últimos siete días y las copias manuales anteriores al borrado pueden conservar datos demo hasta que se retiren. La caducidad no implica una eliminación irreversible de todas las copias.
La demo admite cuerpos de hasta 32 KiB y diez documentos por sesión. La emisión de tokens admite tres por minuto y diez por hora desde una misma IP; la creación, cinco por minuto y veinte por hora desde una misma IP. Los límites compartidos por red, región y carga global pueden aplicarse antes. Estas cifras corresponden a la configuración predeterminada.
Hay límites de emisión, peticiones, documentos y descargas para evitar abusos. También se aplican controles por IP, red, región y carga global; los límites compartidos pueden impedir una solicitud aunque tu token aún no los haya alcanzado. Ante 429, espera los segundos indicados en Retry-After.
El control por región no llama a ningún servicio de geolocalización de IP. Solo utiliza CF-IPCountry cuando la petición llega desde un proxy verificado incluido en DEMO_TRUSTED_GEO_PROXIES, que debe sobrescribir las cabeceras de Cloudflare. Desde otros orígenes, esas cabeceras se ignoran y todas las peticiones comparten el bucket regional unverified; no se atribuyen a un país comprobado.
Protege el token y el secreto k de los enlaces; no los publiques ni los incluyas en registros. Para una integración permanente, solicita acceso a SERTEC PESAGE. Los entornos sk_test_ y sk_live_ mantienen sus propias reglas y datos.