Codificador NYSIIS
Bishop vira BASAP com NYSIIS, um código fonético que dá a mesma chave a nomes escritos de forma diferente, mas com som parecido. Digite um nome ou sobrenome para receber o código e as letras limpas usadas no cálculo. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Nome
- Bishop
- Código
- BASAP
- Normalizado
- BISHOP
- Comprimento
- 6
NYSIIS—o código fonético do New York State Identification and Intelligence System—foi projetado em 1970 para indexar nomes pessoais e de família com maior precisão de correspondência do que o Soundex americano clássico. Mantém uma chave alfabética que preserva mais a forma ortográfica original e, ao mesmo tempo, agrupa vogais e grupos consonantais comuns para que homófonos e quase-homófonos caiam no mesmo código. Este codificador NYSIIS aceita uma string de nome não vazia, remove o que não for letra, aplica as traduções padrão de prefixo e sufixo, percorre o restante com as regras oficiais de colapso e devolve o código resultante junto com a forma normalizada usada na codificação.
Como o NYSIIS constrói uma chave fonética a partir de um nome
O NYSIIS começa convertendo o nome para maiúsculas e mantendo apenas as letras latinas de A a Z; dígitos, espaços, hífens, apóstrofos e pontuação são removidos, de modo que um campo com O'Brien ou brown, sr ainda produz um fluxo estável de letras após a limpeza. As regras de prefixo reescrevem o início do nome: MAC vira MCC, KN vira NN, um K inicial vira C, PH ou PF vira FF, e SCH vira SSS.
As regras de sufixo reescrevem o final: EE ou IE vira Y, e DT, RT, RD, NT ou ND vira D. A primeira letra dessa string transformada é mantida como primeiro caractere da chave.
A partir da segunda letra, a varredura aplica uma regra de cada vez: EV vira AF; qualquer outra vogal vira A; Q vira G; Z vira S; M vira N; KN vira N e o restante K vira C; SCH vira SSS e PH vira FF; H é substituído pela letra anterior quando algum vizinho não é vogal; W após uma vogal é substituído por essa letra anterior. Letras idênticas adjacentes são colapsadas para que corridas não se repitam.
Ao terminar a varredura, o S final é removido, um par AY final vira Y e um A final é removido.
Contrato de entrada, marcas de vazio, formato da resposta e erros comuns
No sucesso a resposta inclui code (o valor alfabético NYSIIS), method igual a nysiis para que roteadores posteriores possam ramificar sem adivinhar formatos, name ecoando a string original, normalized com a sequência A–Z em maiúsculas realmente codificada, empty sempre false no sucesso, e length igual à contagem de caracteres original antes da filtragem. Não trate NYSIIS como criptografia nem como identificador único de pessoa: muitos sobrenomes não relacionados ainda podem colidir, e essa colisão controlada é a vantagem da correspondência difusa, não um bug.
Prefira esta landing quando a intenção de busca for codificador nysiis, código fonético do Estado de Nova York ou correspondência de nomes além do Soundex; o Soundex americano, a soletração fonética OTAN e o Metaphone respondem a intenções diferentes e permanecem em páginas separadas. Letras acentuadas fora da A–Z pura são removidas com as demais não letras, então forneça uma forma normalizada em ASCII se seus dados de origem usam diacríticos e você precisa que essas letras participem.
Esta implementação devolve o código completo após a limpeza final em vez de forçar um corte de seis caracteres, de modo que sobrenomes longos mantêm o detalhe extra para o qual o NYSIIS foi projetado.
Onde o código NYSIIS ajuda a cruzar nomes
Genealogistas e projetos de história local usam um codificador NYSIIS para agrupar sobrenomes de censos, tribunais e listas de passageiros registrados com ortografia inconsistente, retendo mais forma do que um balde Soundex de quatro caracteres. Ferramentas de CRM e de suporte ao cliente podem pré-agrupar sobrenomes parecidos antes de uma revisão humana sem montar um motor completo de resolução de entidades.
Demos de sala de aula de algoritmos de indexação histórica precisam de um oráculo determinístico que os alunos possam chamar do navegador enquanto o professor percorre no quadro as regras de prefixo e de vogais. Notebooks de limpeza de dados podem emitir NYSIIS como uma coluna de features ao lado de minúsculas e Soundex ao construir features de resolução de entidades para linkage de registros. Falhas de validação nunca consomem saldo após a rejeição do motor.
Combine com outras utilidades de texto só quando um passo posterior precisar de outro esquema fonético ou de cifra; mantenha o NYSIIS em sua própria landing para que a intenção SEO continue nítida e o guia seja honesto sobre o que o código alfabético pode e não pode fazer em relação ao Soundex.
Casos de uso
Agrupamento de sobrenomes em genealogia e registros judiciais
Agrupe nomes de família que soam iguais mas foram escritos de forma diferente em registros históricos de Nova York e dos EUA comparando códigos NYSIIS completos.
Pré-correspondência difusa de nomes em CRM
Agrupe sobrenomes de clientes parecidos para revisão humana com mais detalhe que o Soundex sem instalar um stack completo de resolução de entidades.
Perguntas frequentes
Como codifico um nome com NYSIIS?
O campo code da resposta contém o valor NYSIIS (BASAP para Bishop).
Em que o NYSIIS difere do Soundex?
O Soundex devolve uma letra mais três dígitos. O NYSIIS devolve uma chave alfabética com regras de prefixo, sufixo e vogais que mantêm mais detalhe ortográfico para correspondência de nomes.
O codificador NYSIIS é gratuito?
A ferramenta do navegador roda grátis no seu dispositivo.
O resultado é truncado em seis caracteres?
Esta ferramenta devolve o código completo após a limpeza final de S, AY e A. O limite histórico de seis caracteres não é forçado para que nomes longos mantenham mais detalhe.
Dois nomes diferentes podem ter o mesmo código NYSIIS?
Sim, e é exatamente essa a ideia. Muitos sobrenomes sem relação compartilham o mesmo código, e é isso que permite achar correspondências aproximadas. Por isso o código nunca deve servir como identificador único de uma pessoa nem para esconder um nome.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/enc/nysiis \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Bishop"}'const res = await fetch("https://api.kit.forhosting.com/enc/nysiis", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Bishop"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/nysiis",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"name": "Bishop"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/nysiis", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"name":"Bishop"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"name":"Bishop"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/nysiis", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"name": "Bishop"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nysiis",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Entrada vazia, campo name ausente ou string sem letras latinas falha com invalid_input para que quem chama possa sinalizar formulários em branco em vez de inventar um código. O caminho gratuito do navegador e a API pré-paga compartilham a mesma lógica parse pura, de modo que demos de aula e pipelines de correspondência de nomes em produção nunca discordam sobre Bishop, Willis ou Mackenzie.
Como o NYSIIS constrói uma chave fonética a partir de um nome
Como o caminho é aritmética pura de caracteres sem rede e sem relógio, nomes idênticos sempre produzem o mesmo JSON para goldens de integração contínua.
Contrato de entrada, marcas de vazio, formato da resposta e erros comuns
Envie um corpo JSON com o campo string obrigatório name igual ao nome de pessoa ou família que deseja codificar. Os aliases text, input, value e s são aceitos quando os clientes reutilizam nomes de formulário antigos ou widgets de texto compartilhados. Name ausente, valor que não seja string, string de comprimento zero, só espaços ou string sem letras latinas elevam invalid_input e não são cobrados na API pré-paga—é o caminho de marca de entrada vazia que o produto promete, expresso como erro rígido de validação e não como corpo de sucesso com código em branco.
Onde uma API NYSIIS se paga e como funciona o preço
Use a ferramenta gratuita no navegador para checagens pontuais e ensino; use a API KIT pré-paga quando um backend, função serverless ou SDK precisar de um contrato estável com saldo a US$ 0,002 por item bem-sucedido. Mantenha os payloads em comprimentos de nome ordinários adequados a uma chamada de item em um Worker isolate: esta ferramenta é para nomes e rótulos curtos, não para documentos de vários megabytes.
Casos de integração
Demos de índice fonético em sala de aula
Mostre aos alunos que Bishop vira BASAP e que formulários vazios falham com clareza, usando o mesmo caminho gratuito do navegador que a API pré-paga.
Perguntas técnicas
O que acontece se o nome estiver vazio?
A solicitação falha com invalid_input. Entrada ausente, em branco ou sem letras é marcada como vazia e não é cobrada na API pré-paga.