Chave de assinatura de anagramas

Entrada vazia falha com invalid_input em vez de inventar uma chave oca, enquanto sacos só de pontuação no modo somente letras têm sucesso com uma assinatura vazia que ainda serve como chave de grupo.

O que é uma assinatura de anagrama e por que letras ordenadas funcionam

Quando você precisa de um multiconjunto bruto de caracteres para sacos exatos—incluindo espaços, dígitos e pontuação—defina letters_only como false e opcionalmente case_sensitive como true para que cada unidade de código participe. O endpoint nunca afirma significado linguístico, nunca inventa definições de dicionário e nunca enumera rearranjos; só constrói a chave determinística em que algoritmos de agrupamento e correspondência se apoiam.

Contrato de entrada, forma da resposta e comportamento de erros

Envie por POST um corpo JSON com um campo obrigatório, text, a string não vazia que você deseja transformar em assinatura. Os alias input, string, value, content e s são aceitos para que scripts reutilizem nomes comuns. O opcional letters_only vale true por padrão e também pode ser enviado como lettersOnly, alpha_only ou alphaOnly; quando true só restam letras Unicode antes de ordenar, e quando false cada caractere da string (opcionalmente em minúsculas) é mantido. O opcional case_sensitive vale false por padrão e também pode ser enviado como caseSensitive ou sensitive; quando false o texto é colocado em minúsculas primeiro para que anagramas com capitalização mista compartilhem chave, e quando true a capitalização é preservada para que A e a permaneçam distintas na assinatura ordenada. Falta de text, strings vazias, objetos e arrays que não são string, e números não finitos falham com invalid_input e uma mensagem que nomeia o problema—essas falhas de validação não são cobradas. Texto acima do limite max_chars declarado também é rejeitado. Em caso de sucesso o corpo ecoa o text original e seu length, informa signature como a chave ordenada unida, signature_length como o comprimento da chave após o filtro, letters_only e case_sensitive como booleanos resolvidos, e method igual a anagram_signature. Exemplo: listen com padrões produz signature eilnst e signature_length seis. Combine a chave com seus próprios mapas hash ou índices de banco se precisar de busca de anagramas de várias palavras; este endpoint só emite a assinatura e não varre um dicionário nem devolve palavras candidatas.

Onde uma API de assinatura de anagramas agrega valor

Backends de jogos de palavras e ferramentas de palavras cruzadas precisam de uma chave de grupo estável para que toda palavra que rearranja as mesmas letras caia no mesmo balde em consultas e rankings. Plataformas de ensino usam a assinatura como oráculo: o aluno envia um anagrama candidato e o corretor compara assinaturas em vez de ordenar em cada cliente. Validação falha não consome saldo. Pipelines de limpeza de dados que deduplicam nomes de produto ou rótulos difusos às vezes tratam sacos de letras como um primeiro passo barato antes de modelos de similaridade mais pesados, e uma API de parse pequena evita reimplementar filtros de letras Unicode e ordem de classificação em cada linguagem.