Documentación técnica

Renderiza PDFs desde las plantillas que prepara negocio.

La API recibe datos estructurados y devuelve el PDF final. El editor visual se queda en el panel; el backend solo necesita conocer el esquema de campos.

Base URL

/api

Formato

JSON + PDF binario

Autenticación

Bearer API key

Autenticación

Todas las llamadas privadas usan una API key gestionada dentro del área cliente.

Authorization: Bearer df_live_xxxxxxxxx
Content-Type: application/json

Flujo recomendado

Crear plantilla

Sube un PDF y crea una plantilla desde el panel o multipart/form-data.

Consultar esquema

Obtén los campos esperados para saber qué datos debe enviar tu backend.

Renderizar

Tu backend envía JSON y recibe el PDF final como respuesta binaria.

Ejemplo

Renderizar PDF

application/pdf

curl -X POST /api/templates/{templateId}/render \
  -H "Authorization: Bearer df_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -o documento.pdf \
  -d '{
    "cliente": "Clínica Norte",
    "ubicacion": "Vigo",
    "importe": "1840",
    "fecha_inicio": "2026-05-12"
  }'

Endpoints

Método	Ruta	Descripción
POST	`/api/templates`	Crear plantilla desde un PDF.
POST	`/api/templates/{templateId}/fields`	Guardar campos, etiquetas, página y coordenadas.
GET	`/api/templates/{templateId}/schema`	Consultar variables requeridas.
POST	`/api/templates/{templateId}/render`	Generar PDF desde JSON.
GET	`/api/v1/account`	Consultar crédito y estado de cuenta.

Errores

400 Bad Request

PDF inválido, JSON incompleto o campos requeridos ausentes.

401 Unauthorized

API key ausente, incorrecta o inactiva.

402 Payment Required

Crédito insuficiente para crear plantilla o renderizar.

404 Not Found

Plantilla no encontrada.