Extraire une colonne CSV

Ce que signifie extraire une colonne CSV et quand l'utiliser

Lorsque has_header vaut true, la première ligne fournit les noms de colonnes et est exclue du tableau values renvoyé ; lorsqu'il vaut false, chaque ligne est une donnée et vous devez sélectionner par index numérique. Ne l'utilisez pas pour filtrer des lignes par condition, joindre deux fichiers, renommer de nombreuses colonnes ou convertir une table entière en JSON imbriqué — ce sont des intentions produit distinctes avec leurs propres landings.

Contrat d'entrée, sélection par en-tête ou index, et champs de réponse

Le delimiter optionnel vaut la virgule par défaut ; utilisez un seul caractère ou l'orthographe courante "\t" pour la tabulation. La correspondance des en-têtes est sensible à la casse, donc Email et email diffèrent ; lorsqu'un écart de casse seul se résoudrait de façon unique, le message d'erreur peut suggérer l'orthographe disponible. Envoyez un corps JSON avec le champ chaîne obligatoire csv égal au texte non vide du tableau et le column obligatoire égal à un nom d'en-tête ou à un index entier de base zéro (comme nombre ou chaîne purement numérique telle que "0"). Les alias text, input, data, source, content et value sont acceptés pour le corps CSV ; col, field, index et name pour le sélecteur. L'option has_header vaut true par défaut ; mettez-la à false lorsque la première ligne est déjà une donnée. Un csv manquant, vide ou non chaîne, un column manquant, des noms d'en-tête inconnus, des index négatifs ou hors plage et des champs entre guillemets non fermés déclenchent invalid_input avec un message qui nomme le problème, et ces échecs ne sont pas facturés sur l'API prépayée. En cas de succès, la réponse inclut column comme libellé résolu, column_index comme position de base zéro utilisée, values comme les chaînes de cellules ordonnées (chaîne vide si une ligne courte n'a pas cette cellule), count égal à la longueur de values, has_header et delimiter qui reprennent le mode, row_count comme nombre de lignes de données, method toujours csv_select_column, et headers avec les noms de la première ligne uniquement lorsque has_header est true — les champs optionnels sont omis plutôt que null. Utilisez values seul lorsqu'une liste de diffusion n'a besoin que de la colonne ; utilisez headers et column_index pour construire des tableaux d'interface qui mettent en évidence le champ sélectionné.

Usage API, tarification, flux de travail et limites pratiques

Appelez l'outil gratuit dans le navigateur pour extraire une colonne CSV pour des tableaux de devoirs, des exports CRM et des extractions rapides de champ sans écrire un parseur CSV dans chaque langage. Associez ce point de terminaison à filter-csv ou csv-to-json lorsque l'étape suivante est la sélection de lignes ou un tableau d'objets complet, mais conservez l'extraction de colonne CSV comme landing propre pour ne pas mélanger l'intention d'un seul champ avec des transformations multi-colonnes. N'attendez pas d'inférence de types, d'analyse de dates ni de détection automatique de délimiteur au-delà du paramètre delimiter explicite — ce sont des problèmes distincts. Utilisez l'API prépayée KIT lorsqu'un CMS, une étape ETL, un banc de QA, une application de tutorat ou un client mobile a besoin du même contrat sous solde à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet par le moteur. Un flux typique colle un export, sélectionne la colonne email avec has_header true, puis alimente values dans un envoi de courrier ou une étape de déduplication. Les auteurs livrant des SDK peuvent documenter csv et column comme requis, montrer un exemple de succès avec en-tête nommé et un exemple d'erreur de colonne manquante pour que les intégrateurs voient les deux côtés du contrat. Gardez des charges utiles de taille documentaire ordinaire adaptées à un isolate Worker plutôt que des dumps d'entrepôt de plusieurs mégaoctets.