Dígito ID residência China

Corpos sem dígitos, comprimentos incorretos, entrada vazia e caracteres ilegais são rejeitados com um erro claro invalid_input. Use grátis no navegador ou chame a API do KIT; ambos os caminhos compartilham a mesma aritmética modular pura, sem ida e volta de rede e sem registros armazenados de pessoas vivas.

Como o dígito verificador do ID de residente chinês é calculado

Como o algoritmo é aritmética modular inteira pura com pesos fixos, os mesmos dezessete dígitos sempre produzem o mesmo caractere de controle em cada plataforma—navegador, Worker ou harness de testes offline—por isso a capacidade é entregue como motor parse de nível A e não como chamada a um modelo.

Como calcular o dígito de controle ou validar um ID completo

Envie um campo id que contenha apenas dígitos no corpo e, ao validar, um caractere final que seja dígito ou X. O modo validate espera exatamente dezoito caracteres. Essa forma facilita mostrar «você digitou X, esperava-se Y» em uma UI de KYC ou cadastro sem uma segunda requisição. Cadeias vazias, id ausente, valores de mode inválidos e comprimentos incorretos (por exemplo dezesseis ou dezenove caracteres) falham antes de qualquer soma ponderada e não são cobrados. Lembre-se de que um dígito de controle correto só prova boa formação aritmética sob ISO 7064 MOD 11-2—não prova que a pessoa exista em registros civis nem que o documento esteja ativo. Espaços, hífens, pontos e outra pontuação são rejeitados como entrada não ID com invalid_input para que um formulário nunca aceite um valor limpo em silêncio—remova a formatação no seu cliente se o usuário colar uma cadeia com espaços ou hífens. O modo compute é o padrão: forneça exatamente dezessete dígitos base; o motor devolve check_digit como um único caractere de zero a nove ou X, id como o número completo de dezoito caracteres, length dezoito e algorithm iso7064_mod11_2. A resposta indica valid true somente quando o caractere final coincide com expected_check_digit recalculado; sempre inclui base (os primeiros dezessete dígitos), check_digit como enviado, expected_check_digit e o id canônico formado por base mais o caractere esperado. Como o caminho é parse puro, sem relógio, fonte aleatória nem rede, a mesma entrada sempre produz o mesmo JSON na ferramenta gratuita do navegador e na API. A US$ 0,002 por solicitação bem-sucedida você pode proteger importações em massa de CRM, auditorias de arquivos de parceiros e barreiras de formulário sem negociar um nível personalizado.

Onde os dígitos de controle do ID chinês se encaixam em fluxos reais de produto

Fluxos de onboarding de fintech e marketplaces que aceitam clientes da China continental costumam pedir o ID de residente cedo; validar o dígito de controle ao sair do campo reduz envios falhos e tickets de suporte sem chamar um registro nacional a cada tecla. Sistemas de folha, RH e campus que importam CSV de funcionários ou alunos devem colocar em quarentena as linhas cujo décimo oitavo caractere não coincida mais, o que detecta tanto edições humanas quanto bugs de um em geradores anteriores. Não trate um dígito de controle correto como prova de identidade legal ou status de residência—ele só prova que a cadeia de dezoito caracteres está aritmeticamente bem formada sob a regra oficial do ID de residente chinês, o mesmo critério de honestidade que se aplica a qualquer ferramenta de checksum de documentos nacionais. Portais de telecom, viagem e hospitalidade que usam o ID como chave de cidadão podem bloquear o avanço até valid ser true e mostrar expected_check_digit quando o dígito estiver errado. Jobs de qualidade de dados recalculam expected_check_digit para cada coluna de ID em uma exportação e marcam divergências antes de chegarem à faturação ou ao reporting fiscal. Em todo fluxo o contrato é o mesmo: dezessete dígitos para compute ou dezoito caracteres para validate, JSON estruturado que você pode testar com goldens, comportamento idêntico grátis no navegador ou via saldo pré-pago do KIT, e falha honesta quando a entrada não é uma cadeia de ID bem formada. Combine a verificação com suas próprias regras de código de área e intervalo de datas de nascimento se a política do produto exigir; este endpoint limita-se deliberadamente à checagem modular para que a API continue pequena, estável e fácil de testar com goldens a US$ 0,002 por chamada bem-sucedida.