JSON a Excel
JSON a Excel es una API que convierte un array de objetos JSON en un archivo .xlsx real (abre directo en Excel, Google Sheets o Numbers), con las columnas sacadas de las claves de todos los objetos.
Cómo funciona
Le mandas data (un array de objetos) y te devuelve el archivo .xlsx. Si un objeto trae un campo que otros no tienen, esa columna sale igualmente, vacía en las filas donde falte.
Lo único que necesitas
- Tu API key. La creas en tu panel con "+ Crear llave".
- En tu plataforma de automatización, un paso de tipo "HTTP Request" (n8n, Make, Zapier, Pipedream…).
Cómo usarlo en n8n
- Method:
POST· URL:https://api.cofferdock.com/json-to-excel - Send Headers:
x-api-key= tu llave,Content-Type=application/json - Send Body (JSON):
{ "data": [{"nombre":"Ana","edad":30}] } - En Options → Response → Response Format: elige File
Opciones
| Opción | Por defecto | Para qué sirve |
|---|---|---|
data | - | Obligatorio. Array de objetos. |
sheet_name | Sheet1 | Nombre de la hoja (máx. 31 caracteres, límite de Excel). No puede llevar * ? : \ / [ ], empezar o acabar en apóstrofo ni llamarse History: en esos casos devuelve un error 400. |
header | true | Incluir la fila de nombres de columna. |
escape_formulas | false | Ponlo en true si los datos vienen de terceros (formularios, correos, páginas web). Un valor que llegue como objeto (por ejemplo con formula o hyperlink) se escribe como texto en vez de crear una fórmula o un enlace, y los textos que empiezan por =, +, - o @ llevan una comilla simple delante. Por MCP (asistentes de IA) viene en true de serie. Más abajo, el detalle. |
output | json | json (el Excel en base64), xlsx (el archivo tal cual) o url (un enlace de descarga que dura 15 minutos). |
Resumen de la API
- Endpoint:
POST https://api.cofferdock.com/json-to-excel - Auth:
x-api-key: TU_LLAVE. - Entrada: SOLO JSON,
{ "data": [...] }. - Motor: exceljs.
- Límites: 30 peticiones/min por IP. Hasta 100.000 filas y 1.000 columnas (y 2 millones de celdas, filas × columnas). 1 llamada = 1 crédito.
Ejemplo
curl -X POST "https://api.cofferdock.com/json-to-excel" \
-H "x-api-key: TU_LLAVE" -H "Content-Type: application/json" \
-d '{"data":[{"nombre":"Ana","edad":30}],"output":"xlsx"}' \
--output datos.xlsx
Respuesta
{ "success": true, "xlsx": "UEsDBBQA...",
"mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"meta": { "rows": 1, "columns": 2, "used": 12, "remaining": 488 } }
Lo que recibes
Por defecto (JSON): xlsx en base64. Añade output=xlsx para el binario directo, o output=url para un enlace temporal.
Si los datos vienen de terceros
Un archivo de Excel puede llevar fórmulas y enlaces, y quien controle un dato podría colar uno para que la hoja de otra persona envíe información a una web ajena (inyección de fórmulas). "escape_formulas": true cierra los dos caminos:
- Valores con forma de objeto. Si un valor de
dataes un objeto con una clave comoformula, o contextyhyperlink, el archivo lo guarda como una fórmula o un enlace de verdad. Con la opción activa, todo objeto o lista se escribe como texto JSON, como ya pasa con cualquier otro objeto. - Textos que empiezan por
=,+,-o@. En el .xlsx se guardan como texto y Excel no los ejecuta al abrir el archivo, pero pueden acabar ejecutándose si alguien los copia a otro programa o guarda la hoja como CSV. Con la opción activa llevan una comilla simple delante (=1+1sale como'=1+1), igual que los nombres de columna, y también los que empiezan por un tabulador o un retorno de carro. Los números no se tocan.
Por defecto está en false, para que el archivo salga exactamente como siempre. Cuando la herramienta se usa desde un asistente de IA por MCP, viene en true de serie (el asistente puede apagarla mandando false). Actívalo en cuanto mezcles datos que no controlas. La comilla pasa a formar parte del texto y se ve en la hoja: un teléfono que llega como texto +34 600 000 000 saldría como '+34 600 000 000. Si un dato debe seguir siendo un número, envíalo como número (sin comillas). Con la opción activa no puedes mandar fórmulas de verdad en data.