Generar un Word
La API JSON a Word convierte datos estructurados — títulos, párrafos, tablas, listas — en un archivo .docx genuino, del tipo que Word abre y deja editar como si alguien lo hubiera escrito a mano. Es para sistemas que tienen el contenido pero no el documento: un formulario, un registro de base de datos, un informe generado que necesita salir de su flujo vestido de archivo Word real.
Esta tarea no está disponible ahora mismo, así que no se puede contratar. No se cobra nada por ella.
Cómo funciona y APILa brecha entre los datos y el documento
La mayoría del contenido empresarial nace como datos: una fila en una base de datos, un formulario llenado, un objeto devuelto por otro servicio. Convertir eso en algo que una persona lea como documento — con títulos, espaciado y tablas correctos — suele significar que alguien abre Word y le da formato a mano, cada vez. La api generar documento word cierra esa brecha: describe la estructura una sola vez en JSON, y cada documento posterior se genera de la misma forma, de manera correcta, sin que nadie toque un teclado.
Cómo se ve la entrada estructurada
Envía JSON que describe el contenido y la estructura del documento — secciones, títulos, párrafos, tablas, listas — y el servicio lo maqueta como un .docx propiamente dicho: estilos reales de Word, tablas reales con celdas reales, no una imagen disfrazada de documento. Esa distinción importa porque un .docx genuino sigue siendo editable, indexable y accesible; quien lo recibe puede cambiar una frase, ajustar una columna o pasarlo por un lector de pantalla igual que cualquier archivo de Word escrito a mano.
Cómo corre la generación
Llama a POST /doc/generate-docx con su payload estructurado y recibe de inmediato un task_id. La generación ocurre de forma asíncrona en nuestra red global, así que un lote de mil documentos no bloquea su aplicación ni un segundo. Cuando cada archivo está listo, le avisamos por webhook firmado — la opción natural cuando genera documentos en volumen — o por un enlace firmado válido 24 horas si una persona solo necesita recoger un archivo suelto.
Dónde reemplaza el formateo manual
Está pensada para el momento en que un documento debe existir porque un proceso terminó, no porque alguien decidió escribirlo: una plantilla de contrato llenada con datos del CRM, un documento de política ensamblado desde una base de datos de cumplimiento, una carta de oferta personalizada generada por candidato, un informe interno compilado desde salidas de analítica. Donde sea que el contenido ya esté estructurado en su sistema, este endpoint lo convierte en el formato de documento que el destinatario en verdad espera, como un paso automatizado más y no como una tarea manual.
Precio simple, seguro por defecto
La generación se cobra a una tarifa plana de $0.002 por solicitud — una sola tarifa publicada, sin tokens, sin créditos inventados, sin cargos sorpresa. Una tarea que falla nunca se cobra; reintentamos tres veces y, si el documento aún no puede construirse, recibe un error claro que explica el motivo. El acceso requiere saldo prepago, que es lo que mantiene el servicio rápido y sin abuso — no hay plan gratuito ni prueba, y las solicitudes sin saldo devuelven un 402. Sus datos de entrada y el archivo generado se eliminan tras la ventana de retención y nunca se usan para entrenar nada.
Qué puede hacer con ella
Contratos llenados con datos del CRM
Una plataforma de ventas genera un contrato .docx listo para firmar por cada trato cerrado, tomando cláusulas y condiciones directamente del registro del CRM.
Cartas de oferta personalizadas
Un sistema de recursos humanos produce una carta de oferta con el formato correcto para cada candidato aceptado, tomando puesto, salario y fecha de inicio del registro del postulante.
Documentos de política desde una base de cumplimiento
Una herramienta de cumplimiento ensambla un documento de política con secciones numeradas y tablas directamente desde las reglas guardadas en su base de datos.
Informes compilados desde analítica
Un panel interno exporta un resumen semanal — títulos, tablas de cifras, notas — como un documento de Word editable para equipos que prefieren anotarlo fuera de línea.
Preguntas frecuentes
¿Cómo genero un documento Word con una API?
Envía JSON estructurado con títulos, párrafos y tablas a POST /doc/generate-docx y recibe un task_id. La api generar documento word construye el .docx de forma asíncrona y lo entrega por webhook firmado o por un enlace firmado válido 24 horas.
¿Esta API es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿El resultado es un .docx real y editable?
Sí. El servicio produce un documento de Word genuino con estilos, tablas y texto reales — totalmente editable, indexable y accesible — no una imagen ni un PDF aplanado renombrado a .docx.
¿Puedo incluir tablas, listas y títulos?
Sí, los tres. Describe secciones, títulos, párrafos, tablas y listas en JSON y se maquetan como elementos nativos de Word en el archivo generado.
¿Puedo generar documentos de forma masiva?
Sí. Como el endpoint es asíncrono y devuelve un task_id por solicitud, puede disparar muchas generaciones en paralelo desde una cola o un proceso por lotes sin bloquear.
¿Qué pasa si la generación falla?
Una tarea fallida nunca se cobra. Reintentamos tres veces con espera progresiva y, si el documento aún no puede construirse, recibe un error claro en lugar de un fallo silencioso o un cargo.
¿En qué se diferencia de llenar una plantilla de Word a mano?
No hay una plantilla que abrir ni mantener en una app de escritorio. Envía los datos estructurados una vez y la API construye el .docx de forma programática, así que generar documentos se vuelve un paso que disparan sus propios sistemas, no una tarea asignada a una persona.
¿Cuánto tiempo puedo acceder al archivo generado?
El enlace firmado permanece válido 24 horas, o puede recibir el archivo de inmediato por webhook firmado. Tras la ventana de retención se elimina y nunca se usa para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/doc/generate-docx \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/doc/generate-docx", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/generate-docx",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/generate-docx", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/generate-docx", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "doc.generate_docx",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |