--- title: "API REST" description: "Una API HTTP para 45 rutas de conversión de archivos, 5 rutas de captura de páginas web y siete endpoints de inteligencia web. Una key, una URL base, enlaces de descarga prefirmados de vuelta." canonical: "https://www.enconvert.com/es/integrations/rest-api" locale: "es" --- API REST oficial # Una API HTTP. Todas las conversiones, una sola URL base. Cuarenta y cinco rutas de conversión de archivos repartidas entre formatos de datos, documentos e imágenes, cinco rutas de captura de páginas web y siete endpoints de inteligencia web que renderizan, buscan, extraen y monitorean páginas en vivo. Todo cuelga de api.enconvert.com, y cada conversión responde con un enlace de descarga prefirmado. curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf -H "X-API-Key: sk\_..." -d '{"url":"https://example.com"}' Copiar Autenticación ## Dos tipos de key, a una cabecera de distancia. Elige la key que corresponda al origen de la petición. Ambas se crean y revocan desde el panel. ### Private keys para tu servidor Envía una key que empieza por sk\_ en la cabecera X-API-Key. Acceso total a cada endpoint, incluidos los modos síncrono, asíncrono y por lotes. Las keys se guardan como hashes SHA-256, así que el texto plano se muestra una sola vez al crearla, y nunca más. `X-API-Key: sk_...` ### Public keys para el navegador Intercambia una key que empieza por pk\_ por un JWT de corta duración en POST /v1/auth/token, y luego envíalo como Authorization: Bearer. Las public keys solo funcionan desde los dominios que autorices, y POST /v1/auth/refresh renueva el token antes de que expire. `Authorization: Bearer ` Una private key usada desde un navegador se rechaza sin más. La API lee la cabecera Origin y niega las keys sk\_ desde entornos de navegador, así que una key de servidor filtrada no se puede reproducir desde una página. [ Lee la guía de autenticación ](/docs/authentication.md) Endpoints ## Cuarenta y cinco rutas de conversión de archivos, cinco de captura web. Siete más para la propia web. Los endpoints de páginas web reciben un cuerpo JSON con URLs. Los endpoints de formatos de datos, documentos e imágenes reciben una subida multipart/form-data. Los endpoints V2 reciben JSON y comparten las mismas keys y la misma lista de dominios permitidos, con sus propios contadores de cuota. 1. 01 ### Páginas web 5 endpoints Renderiza cualquier URL como PDF, captura de pantalla o Markdown limpio, y convierte un sitio entero en un solo documento. Se admiten tanto el procesamiento por lotes como el asíncrono. `POST /v1/convert/url-to-pdf` 2. 02 ### Formatos de datos 11 endpoints JSON hacia y desde XML, YAML, CSV y TOML, CSV hacia y desde XML, y Markdown a HTML. Datos estructurados que entran, datos estructurados que salen. `POST /v1/convert/json-to-xml` 3. 03 ### Documentos a PDF 13 endpoints HTML, Markdown, Word, Excel, PowerPoint, la familia OpenDocument, Pages y Numbers, todos renderizados a PDF con la misma forma de petición. Dos rutas comodín convierten casi cualquier archivo a PDF o Markdown. `POST /v1/convert/doc-to-pdf` 4. 04 ### Conversiones de imagen 21 endpoints JPEG, PNG, WebP, HEIC y SVG en cualquier combinación, además de PDF a JPEG. Un compresor que respeta la calidad tiene además su propia ruta. `POST /v1/convert/heic-to-webp` 5. 05 ### Inteligencia web 7 endpoints perceive, discover, lookup, distill, ingest y watch. Renderiza una página, mapea un sitio, resuelve una entidad, extrae campos estructurados, construye pasajes incrustables, y recibe un aviso cuando una página cambia. `POST /v2/perceive` Los errores vuelven como JSON con un campo detail: 401 si falta la key o es inválida, 402 cuando se alcanza el límite mensual, 403 para un dominio o endpoint que tu key no puede usar, y 413 para un archivo que supera el límite de tamaño de tu plan. [ Explora cada endpoint ](/docs/endpoints.md) En la práctica ## Una petición y una respuesta. Cada endpoint sigue la misma forma. Envía una key, recibe un enlace de descarga prefirmado y los metadatos que lo acompañan. ``` $curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \$ -H "X-API-Key: sk_your_private_key" \$ -H "Content-Type: application/json" \$ -d '{"url": "https://example.com"}'{ "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...", "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf", "filename": "example_20250202_120530123.pdf", "file_size": 45678, "conversion_time_seconds": 3.21} ``` Construido sobre esto ## Una API, cuatro puertas de entrada. REST es la base. Cada otra superficie es una forma más ligera de llegar a los mismos endpoints con la misma key. ### SDK de Node.js Métodos tipados, descargas en streaming, recuperación automática de un trabajo que agotó el tiempo de espera, y una jerarquía de errores real en lugar de ramificar por código de estado. Cero dependencias en tiempo de ejecución, ESM y CJS. [ Ver en npm ](https://www.npmjs.com/package/@enconvert/node-sdk) ### Herramienta de línea de comandos Toda la API en un solo comando de terminal, para shells, scripts y trabajos de CI donde un cliente HTTP es más ceremonia de la que la tarea merece. [ Ver la CLI ](/es/integrations/cli.md) ### Nodo n8n Convierte, extrae y rastrea dentro de un flujo sin escribir una petición ni gestionar tú mismo el sondeo de un trabajo. [ Ver el nodo n8n ](/es/integrations/n8n.md) ### Servidor MCP Los mismos endpoints expuestos como herramientas que tu agente puede llamar directamente, para Claude, Cursor y Windsurf. [ Ver el servidor MCP ](/es/mcp.md) ## Preguntas sobre la API ¿Cuál es la URL base de la API de EnConvert? https://api.enconvert.com. Cada endpoint v1 y v2 cuelga de esa única URL base, así que no hay nada regional ni por tenant que configurar. ¿Cómo me autentico? Para llamadas de servidor a servidor, envía una private key que empieza por sk\_ en la cabecera X-API-Key. Para llamadas desde el navegador, intercambia una public key que empieza por pk\_ por un JWT de corta duración en POST /v1/auth/token y envíalo como Authorization: Bearer. Las public keys solo funcionan desde los dominios que autorices en el panel. ¿Cuál es la diferencia entre V1 y V2? V1 son las 45 rutas de conversión de archivos y las 5 rutas de captura de páginas web: entran archivos y páginas web, salen archivos convertidos. V2 son siete endpoints de inteligencia web (perceive, convert, discover, lookup, distill, ingest y watch) que renderizan, buscan, extraen y monitorean páginas en vivo. Usan las mismas keys y la misma lista de dominios permitidos, y se miden con contadores independientes. ¿Envío una URL o subo un archivo? Ambas cosas, según el endpoint. Los cinco endpoints de páginas web reciben un cuerpo JSON con la URL. Los endpoints de formatos de datos, documentos e imágenes reciben una subida de archivo multipart/form-data. ¿Qué pasa cuando alcanzo el límite de mi plan? La API responde 402 con un campo detail que indica el uso y el límite permitido. Un batch que te haría superar el saldo restante se rechaza de entrada en lugar de procesarse a medias, así que nunca se te cobra por una ejecución a medio terminar. ¿Hay un SDK oficial? Sí, @enconvert/node-sdk para Node.js y TypeScript. Llama a los mismos endpoints públicos con cero dependencias en tiempo de ejecución y distribuye tanto builds ESM como CJS, así que las llamadas del SDK y las llamadas HTTP directas se mezclan sin problema en el mismo código. ## Empieza con una sola petición. La guía de inicio rápido recorre tu primera conversión en tres pasos, con ejemplos en cURL, Python y JavaScript. [Lee la guía de inicio rápido](/docs/quickstart.md)[Consigue una API key](/es/dashboard/api-keys)