--- seo_title: API de XML a CSV | Convierte XML tabular a CSV | EnConvert meta_desc: Convierte XML a CSV con POST /v1/convert/xml-to-csv. Aplana XML tabular con elementos repetidos en filas separadas por comas, directo o mediante URL prefirmada. keywords: api xml a csv, convertir xml a csv, xml a csv api rest, xml tabular a csv api, xml a csv python, xml a csv curl, exportar datos xml a csv api --- # API de XML a CSV La API de XML a CSV convierte un archivo XML tabular a formato CSV con una sola solicitud a `POST /v1/convert/xml-to-csv`. Espera elementos hermanos planos y repetidos con elementos hijos consistentes, y desenvuelve automáticamente los contenedores `` e ``. La respuesta es CSV sin procesar por defecto, o establece `direct_download=false` para obtener metadatos con una URL de descarga prefirmada. --- ## Endpoint ``` POST /v1/convert/xml-to-csv ``` **Content-Type:** `multipart/form-data` **Entrada aceptada:** archivos `.xml` (codificados en UTF-8) **Formato de salida:** `.csv` (`text/csv`) --- ## Autenticación Requiere una clave API privada o un token JWT obtenido de una clave pública. ``` X-API-Key: sk_your_private_key ``` O bien: ``` Authorization: Bearer ``` --- ## Parámetros de la solicitud | Parámetro | Tipo | Obligatorio | Predeterminado | Descripción | |-----------|------|----------|---------|-------------| | `file` | file | Sí | -- | El archivo `.xml` a convertir. Debe contener datos tabulares (elementos repetidos con campos consistentes). Codificado en UTF-8. | | `output_filename` | `string` | No | Nombre del archivo de entrada | Nombre de archivo de salida personalizado. La extensión `.csv` se añade automáticamente. | | `direct_download` | `boolean` | No | `true` | Con `true`, devuelve los bytes CSV sin procesar. Con `false`, devuelve metadatos con una URL de descarga prefirmada. | --- ## Reglas de conversión ```xml Alice 30 London Bob 25 Paris ``` Se convierte en: ```csv name,age,city Alice,30,London Bob,25,Paris ``` - Desenvuelve automáticamente el contenedor `` (diccionario raíz de una sola clave) - Desenvuelve automáticamente el contenedor `` (diccionario de una sola clave que contiene la lista) - Si se encuentra un único registro XML (no envuelto en una lista), se envuelve automáticamente en una lista - Los encabezados de columna se derivan de los nombres de etiqueta de los hijos del primer elemento - El delimitador es la coma (no configurable) y el entrecomillado es mínimo
Importante: Este endpoint solo funciona con XML "tabular" -- elementos hermanos planos y repetidos con elementos hijos consistentes. El XML profundamente anidado o con contenido mixto fallará o producirá resultados inesperados. Para estructuras XML complejas, usa xml-to-json en su lugar.
--- ## Respuesta ### Descarga directa (`direct_download=true`, predeterminado) ``` HTTP 200 OK Content-Type: text/csv Content-Disposition: inline; filename="data_20260405_123456789.csv" ``` ### Respuesta con metadatos (`direct_download=false`) ```json { "presigned_url": "https://spaces.example.com/...", "object_key": "env/files/{project_id}/xml-to-csv/data_20260405_123456789.csv", "filename": "data_20260405_123456789.csv", "file_size": 1234, "conversion_time_seconds": 0.03 } ``` --- ## Ejemplos de código ### Python ```python import requests with open("data.xml", "rb") as f: response = requests.post( "https://api.enconvert.com/v1/convert/xml-to-csv", headers={"X-API-Key": "sk_your_private_key"}, files={"file": ("data.xml", f, "application/xml")} ) with open("data.csv", "wb") as out: out.write(response.content) ``` ### Node.js ```javascript const form = new FormData(); form.append("file", fs.createReadStream("data.xml")); const response = await fetch("https://api.enconvert.com/v1/convert/xml-to-csv", { method: "POST", headers: { "X-API-Key": "sk_your_private_key" }, body: form }); const csv = await response.text(); ``` ### PHP ```php $ch = curl_init("https://api.enconvert.com/v1/convert/xml-to-csv"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"], CURLOPT_POSTFIELDS => ["file" => new CURLFile("data.xml", "application/xml")] ]); $csv = curl_exec($ch); curl_close($ch); ``` ### Go ```go body := &bytes.Buffer{} writer := multipart.NewWriter(body) part, _ := writer.CreateFormFile("file", "data.xml") file, _ := os.Open("data.xml") io.Copy(part, file) writer.Close() req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/xml-to-csv", body) req.Header.Set("Content-Type", writer.FormDataContentType()) req.Header.Set("X-API-Key", "sk_your_private_key") resp, _ := http.DefaultClient.Do(req) ``` --- ## Respuestas de error | Estado | Condición | |--------|-----------| | `400 Bad Request` | El archivo no es un archivo `.xml` | | `400 Bad Request` | La estructura XML no se puede convertir a CSV (no es tabular) | | `400 Bad Request` | El XML debe contener elementos con campos consistentes para la conversión a CSV | | `400 Bad Request` | Codificación XML no válida (se espera UTF-8) | | `401 Unauthorized` | Clave API o token JWT ausente o no válido | | `402 Payment Required` | Cuota mensual de ops agotada | | `413 Payload Too Large` | El archivo supera el tamaño máximo del plan | --- ## Límites | Límite | Valor | |-------|-------| | Tamaño máximo de archivo | Según el plan (Founding: 5 MB) | | Codificación de entrada | Solo UTF-8 | | Estructura XML | Solo tabular (elementos planos y repetidos) | | Conversiones mensuales | Según el plan | --- ## Preguntas frecuentes ### ¿Cómo convierto XML a CSV con una API REST? Envía una solicitud POST `multipart/form-data` a `POST /v1/convert/xml-to-csv` con tu archivo `.xml` en el campo `file`, autenticándote con una cabecera `X-API-Key` o un token JWT `Authorization: Bearer`. Por defecto, el cuerpo de la respuesta son los bytes CSV sin procesar. ### ¿Por qué mi conversión de XML a CSV falla con un error 400? Se devuelve un `400 Bad Request` cuando la estructura XML no es tabular, los elementos no tienen campos consistentes, el archivo no es un archivo `.xml` o la codificación no es UTF-8. ### ¿Puedo convertir XML profundamente anidado a CSV? No. Este endpoint solo funciona con XML tabular, es decir, elementos hermanos planos y repetidos con elementos hijos consistentes. Para estructuras XML complejas o profundamente anidadas, usa el endpoint xml-to-json en su lugar. ### ¿Cómo se determinan los encabezados de columna del CSV a partir del XML? Los encabezados de columna se derivan de los nombres de etiqueta de los hijos del primer elemento. Los contenedores `` e `` se desenvuelven automáticamente, y un registro único se envuelve automáticamente en una lista. ### ¿Puedo cambiar el delimitador del CSV en la salida? No. El delimitador es la coma y no es configurable; el entrecomillado es mínimo.