Contar itens de lista

Entrada vazia falha com invalid_input para que pipelines não armazenem cargas de comprimento zero por acidente.

O que significa contar itens de lista e como linhas em branco são tratadas

O campo principal count (também exposto como item_count) é igual a non_blank_lines quando ignore_blank é true, e igual a total_lines quando ignore_blank é false.

Contrato de entrada, opção ignore_blank e leitura dos campos de resposta

Envie um corpo JSON com o campo de string obrigatório text definido para a lista não vazia que deseja medir. Os aliases input, value, s, content, body e list são aceitos quando clientes antigos ou geradores de formulário usam esses nomes. O opcional ignore_blank tem padrão true; os aliases skip_blank, skip_empty e ignore_empty mapeiam para a mesma flag. Valores booleanos funcionam diretamente; formas de string true false yes no on off e o numérico zero ou um também são aceitos para que posts de formulário e clientes no estilo consulta permaneçam simples. text ausente, um valor que não é string ou uma string de comprimento zero elevam invalid_input com uma mensagem que nomeia o problema, e essas falhas não são cobradas na API pré-paga. Texto só com espaços é permitido quando não tem comprimento zero: com ignore_blank padrão informa count zero e blank_lines igual a total_lines, que é o resultado de inventário correto para uma lista sem itens reais. Em caso de sucesso a resposta inclui count e item_count como total de inventário sob a opção atual, total_lines como cada segmento de linha, blank_lines e non_blank_lines para auditoria, ignore_blank ecoando a configuração usada, character_count como o comprimento UTF-16 da string original, original ecoando a entrada exata para tabelas de UI, e method sempre count_list_items para que o código a jusante possa ramificar sem cheirar formatos. Use count sozinho quando um crachá só precise de quantos itens existem; use blank_lines quando uma checagem de estilo se preocupe com linhas espaçadoras vazias entre blocos; defina ignore_blank como false quando uma quebra final deva aumentar a contagem para combinar com um protocolo estrito orientado a linhas. Mantenha as cargas em tamanhos ordinários de mensagens e documentos adequados a um isolado Worker em vez de dumps multi-megabyte; este produto é uma utilidade de texto para listas, não um armazém em massa de arquivos.

Uso da API, preços, fluxos de trabalho e limites práticos

Chame a ferramenta gratuita de contar itens de lista no navegador para listas de compras, checklists de bagagem, listas de turma, backlogs de sprint e auditorias de paste-bin sem instalar wc nem escrever um script em cada linguagem. Um fluxo típico cola um rascunho de lista de bagagem, conta itens com vazios ignorados e depois compara com uma meta de embalagem antes da viagem. Use a API pré-paga do KIT quando um CMS, um pipeline de conteúdo, um harness de QA ou um cliente móvel precisarem do mesmo contrato sob saldo a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Emparelhe este endpoint com ferramentas de ordenação ou de palavras únicas quando o próximo passo for limpar a lista, mas mantenha contar itens de lista como landing própria para que a intenção de busca count-list-items não se misture com estatísticas genéricas de linha ou frequência de palavras. Não espere parse de colunas CSV, comprimento de arrays JSON nem remoção de marcadores de marcadores — são problemas separados com termos SEO separados. Autores que publicam SDKs podem documentar text como o único campo obrigatório, mostrar ignore_blank com padrão true e enviar um exemplo de sucesso multilinha mais um exemplo de erro de string vazia para que integradores vejam os dois lados do contrato.