Extraer columna CSV

Qué significa extraer una columna CSV y cuándo usarlo

Cuando has_header es true, la primera fila aporta los nombres de columna y se excluye del array values devuelto; cuando es false, cada fila es dato y debe seleccionar por índice numérico. No la use para filtrar filas por condición, unir dos archivos, renombrar muchas columnas o convertir toda una tabla a JSON anidado: son intenciones de producto distintas con sus propias landings.

Contrato de entrada, selección por cabecera o índice y campos de respuesta

El delimitador opcional es la coma por defecto; use un solo carácter o la forma habitual "\t" para tabulador. La coincidencia de cabeceras distingue mayúsculas y minúsculas, de modo que Email y email son distintos; cuando un desajuste solo de mayúsculas se resolvería de forma única, el mensaje de error puede sugerir la forma disponible. Envíe un cuerpo JSON con el campo de cadena obligatorio csv igual al texto no vacío de la tabla y el column obligatorio igual a un nombre de cabecera o a un índice entero base cero (como número o cadena numérica pura como "0"). Se aceptan los alias text, input, data, source, content y value para el cuerpo CSV; col, field, index y name para el selector. El opcional has_header vale true por defecto; póngalo en false cuando la primera fila ya sea dato. Falta de csv, csv vacío, csv no cadena, column ausente, nombres de cabecera desconocidos, índices negativos o fuera de rango y campos entre comillas sin cerrar provocan invalid_input con un mensaje que nombra el problema, y esos fallos no se cobran en la API prepago. En éxito la respuesta incluye column como etiqueta resuelta, column_index como posición base cero usada, values como las cadenas de celda en orden (cadena vacía si una fila corta carece de esa celda), count igual a la longitud de values, has_header y delimiter que repiten el modo, row_count como número de filas de datos, method siempre csv_select_column, y headers con los nombres de la primera fila solo cuando has_header es true: los campos opcionales se omiten en lugar de null. Use solo values cuando una lista de correo solo necesite la columna; use headers y column_index al construir tablas de interfaz que resalten el campo elegido.

Uso de la API, precios, flujos de trabajo y límites prácticos

Utilice la herramienta gratuita en el navegador para extraer una columna CSV en tablas de deberes, exportaciones de CRM y extracciones rápidas de campo sin escribir un analizador CSV en cada lenguaje. No espere inferencia de tipos, análisis de fechas ni detección automática de delimitador más allá del parámetro delimiter explícito: son problemas aparte. Use la API prepago de KIT cuando un CMS, un paso ETL, un arnés de QA, una app tutorial o un cliente móvil necesiten el mismo contrato con saldo a $0.002 por elemento correcto; los fallos de validación no consumen saldo tras el rechazo del motor. Un flujo típico pega una exportación, selecciona la columna email con has_header true y luego pasa values a un envío o a un paso de deduplicación. Combine este endpoint con filter-csv o csv-to-json cuando el siguiente paso sea seleccionar filas o un array completo de objetos, pero mantenga extraer columna CSV como landing propia para no mezclar la intención de un solo campo con transformaciones de muchas columnas. Quienes publiquen SDK pueden documentar csv y column como obligatorios, mostrar un ejemplo de éxito con cabecera con nombre y un error de columna ausente para que los integradores vean ambos lados del contrato. Mantenga las cargas en tamaños de documento ordinarios aptos para un isolate de Worker, no volcados de almacén de varios megabytes.