# Perguntas frequentes

> Respostas sobre requisições V2, confiança, resultados desconhecidos, créditos, privacidade e conta. Se você mantém uma integração com a versão anterior, use a documentação da V1.

Canonical HTML: https://www.genderapi.io/pt/frequently-asked-questions

Last reviewed: 2026-09-29

## Informações gerais

Respostas sobre requisições V2, confiança, resultados desconhecidos, créditos, privacidade e conta. Se você mantém uma integração com a versão anterior, use a documentação da V1.

## Entenda as previsões e seus limites

Contexto de país, valores de confiança e resultados desconhecidos na API V2.

### Um resultado da GenderAPI define o gênero de uma pessoa?

Não. A GenderAPI infere o gênero a partir de sinais ligados ao nome ou, quando a opção está ativada, a partir de sinais presentes em apelidos. Uma previsão não é um dado verificado sobre uma pessoa. Preserve a incerteza, respeite a identidade de gênero informada pela própria pessoa e não tome decisões com consequências relevantes com base apenas nessa estimativa.

### Como o contexto de país influencia um resultado?

Um código de país ISO opcional, em letras maiúsculas, dá à requisição um contexto regional. Informe-o apenas quando for pertinente e conhecido. O mesmo nome pode ser usado de formas diferentes em cada região; o país retornado descreve uma associação com o nome e não comprova cidadania nem residência.

[País e parâmetros da requisição →](https://www.genderapi.io/pt/docs/v2/request-parameters)

### O que significa o valor de confiança na V2?

confidence é um valor de 0 a 1, ou null quando nenhum valor está disponível. Leia-o junto com confidence_kind: observed_frequency indica a contagem da categoria predominante no conjunto de dados dividida pela contagem total; model_reported é um valor informado pela IA. Esses valores não são probabilidades calibradas sobre uma pessoa nem uma precisão medida do produto. Defina seus limites de revisão com base em dados representativos.

[Campos de resposta e evidências →](https://www.genderapi.io/pt/docs/v2/responses)

### O que significa gender: null e esse resultado é cobrado?

Um resultado V2 bem-sucedido com gender: null significa que os sinais disponíveis não permitiram determinar o gênero. Trata-se do valor null nativo do JSON, não da string "null". Um resultado desconhecido bem-sucedido é cobrado conforme o custo do modo escolhido. Trate-o como desconhecido; um erro do provedor ou da requisição é um caso de erro distinto.

[Resultados desconhecidos →](https://www.genderapi.io/pt/docs/v2/responses)[Regras de cobrança de créditos →](https://www.genderapi.io/pt/docs/v2/credits-and-usage)

### Posso enviar nomes em diferentes sistemas de escrita?

Sim. Envie os nomes em Unicode, com os caracteres originais e os sinais diacríticos relevantes. A cobertura e a confiança dependem do nome, da região e dos sinais disponíveis. Por isso, teste uma amostra representativa dos sistemas de escrita e dos países atendidos pela sua aplicação.

[Exemplos de requisições com nomes →](https://www.genderapi.io/pt/docs/v2/gender-from-name)

## Escolha o tipo de requisição e as opções de IA

Tipos de requisição V2, lotes, comportamento da IA e limites de uso.

### Posso analisar nomes, endereços de e-mail e nomes de usuário em lote?

Sim. POST /api/v2/gender/batch aceita até 50 itens com chave de API ou 10 com o teste por IP. Cada item tem seus próprios campos type e value, um country opcional e configurações de IA próprias. Por padrão, a IA fica desativada para os itens de um lote. Verifique cada resultado: um lote pode retornar HTTP 200 mesmo quando alguns itens falham. Os créditos são cobrados por item processado com sucesso, inclusive pelos resultados desconhecidos.

[Requisições em lote e erros parciais →](https://www.genderapi.io/pt/docs/v2/batch)

### Como funciona uma requisição com endereço de e-mail?

Use type: email com um endereço válido. A API procura um sinal de nome aproveitável na parte local, antes do @; o domínio não diz nada sobre a identidade ou o país de uma pessoa. Caixas compartilhadas e endereços sem sinal de nome podem gerar um resultado desconhecido. Uma requisição individual usa a IA por padrão quando o conjunto de dados não fornece um resultado.

[Exemplos de requisições com e-mail →](https://www.genderapi.io/pt/docs/v2/gender-from-email)

### Como funciona uma requisição com nome de usuário?

Use type: username. Uma requisição normal procura um nome reconhecível em um nome de usuário ou nome de exibição. Apelidos abstratos podem gerar um resultado desconhecido. Ative forceToGenderize se quiser que, depois de uma consulta sem resultado no conjunto de dados, a IA seja usada com análise de apelidos; assim, o gênero pode ser determinado mesmo sem extrair um nome real.

[Exemplos de nomes de usuário e apelidos →](https://www.genderapi.io/pt/docs/v2/gender-from-username)

### Quando a V2 usa IA?

As requisições individuais usam por padrão options.ai_mode: fallback: o conjunto de dados é consultado primeiro e, se o gênero não for determinado, a IA é usada, por 1 crédito no total. off usa apenas o conjunto de dados, por 1 crédito; always ignora o conjunto de dados e usa a IA, por 2 créditos. Os itens de um lote usam off por padrão e podem ativar a IA individualmente. Nenhum desses modos garante um resultado diferente de null.

[Opções de IA e custos →](https://www.genderapi.io/pt/docs/v2/ai-options)

### O que o forceToGenderize faz?

Essa flag opcional funciona com nomes, endereços de e-mail e nomes de usuário, inclusive em itens individuais de um lote. Um resultado determinado pelo conjunto de dados custa 1 crédito. Caso contrário, a IA é usada com análise de apelidos, por 2 créditos no total, mesmo que o resultado bem-sucedido continue desconhecido. Não é necessário um nome real. Omita ai_mode ou use fallback; combinar a flag com off ou always retorna 422.

[Análise de apelidos →](https://www.genderapi.io/pt/docs/v2/ai-options)

### Como os créditos são cobrados na V2?

Leia meta.usage.charged_credits para ver os créditos efetivamente cobrados em uma operação e billing_status para a confirmação da cobrança. As previsões normais pelo conjunto de dados e no modo fallback custam 1 crédito por item processado com sucesso; always e a IA com análise de apelidos custam 2 créditos. Uma validação de número de telefone concluída custa 1 crédito, mesmo com resultado inválido. Basta um saldo inicial positivo, por isso a cobrança final pode deixar o saldo negativo. Os créditos de previsões que falharam são estornados; uma cobrança não confirmada deve ser verificada pelo suporte.

[Créditos e uso →](https://www.genderapi.io/pt/docs/v2/credits-and-usage)[Ver os pacotes →](https://www.genderapi.io/pt/price)

### Existem limites de requisições na V2?

Sim. Os valores padrão atuais são 120 requisições por minuto por conta, 600 por minuto por endereço IP e 2 operações simultâneas por conta. Também se aplica a capacidade compartilhada do serviço. As requisições POST são limitadas a 64 KiB; os lotes aceitam 50 itens com chave ou 10 com o teste por IP. Trate o HTTP 429 e o Retry-After em vez de supor que as requisições dentro desses limites sempre serão aceitas.

[Limites e tratamento de novas tentativas →](https://www.genderapi.io/pt/docs/v2/errors-and-retries)

### Posso repetir uma requisição que falhou ou excedeu o tempo limite?

Cada requisição de previsão é uma nova operação e é cobrada normalmente. Um tempo limite esgotado ou uma resposta perdida não comprova que nenhum crédito foi cobrado. Verifique billing_status antes de tentar novamente; se a cobrança não estiver confirmada, entre em contato com o suporte informando o request_id. Em um lote com falha parcial, repita apenas os itens que falharam quando a cobrança estiver confirmada. Em caso de 429, respeite o cabeçalho Retry-After.

[Erros e novas tentativas seguras →](https://www.genderapi.io/pt/docs/v2/errors-and-retries)

### Onde encontro exemplos de código e ferramentas para a V2?

Os guias da V2 trazem exemplos em cURL, JavaScript, Python, PHP, Java, C# e Go. O Swagger e o Postman usam o mesmo contrato V2. Escolha o tipo de entrada e mantenha sua chave de API na configuração do lado do servidor.

[Documentação da V2 →](https://www.genderapi.io/pt/api-documentation)[Swagger V2 →](https://www.genderapi.io/swagger/v2/)

### Posso continuar usando a V1?

Sim. As integrações V1 existentes mantêm seus endpoints e formatos de resposta. A V1 e a V2 usam a mesma chave de API e o mesmo saldo, mas diferem nos campos da requisição, nas respostas e nos erros. Use a documentação separada da V1 para manter um cliente existente e o guia de migração quando quiser passar para a V2.

[Documentação da V1 →](https://www.genderapi.io/pt/api-documentation/v1)[Migrar da V1 para a V2 →](https://www.genderapi.io/pt/docs/v2/migration)

## Entenda como os dados são tratados

Onde encontrar informações atualizadas sobre tratamento, retenção e exclusão.

### As requisições bem-sucedidas à GenderAPI são armazenadas?

A Política de Privacidade explica quais dados de requisições, dados operacionais e registros de segurança podem ser mantidos, para quais finalidades são tratados e como ocorre a exclusão. Verifique essas informações para a sua integração e não envie dados pessoais desnecessários.

[Política de Privacidade →](https://www.genderapi.io/pt/privacy-policy)

### Os endereços de e-mail enviados nas requisições são armazenados?

A Política de Privacidade descreve como são tratados os endereços de e-mail enviados nas requisições e os dados técnicos relacionados. Um endereço de e-mail pode ser um dado pessoal: envie apenas o que a requisição exige e não guarde endereços completos nos seus logs de diagnóstico.

[Endereços de e-mail e privacidade →](https://www.genderapi.io/pt/privacy-policy)

### Por quanto tempo os arquivos Excel ou CSV enviados são mantidos?

A Política de Privacidade define a retenção, a exclusão e os backups dos arquivos enviados. Exporte os resultados de que você precisa e exclua o arquivo com as funções da área de trabalho quando ele não for mais necessário. Entre em contato com o suporte se tiver dúvidas sobre os requisitos de retenção da sua organização.

[Retenção de arquivos →](https://www.genderapi.io/pt/privacy-policy)[Fale com o suporte →](https://www.genderapi.io/pt/contact)

### Prestadores de serviço podem tratar os dados das requisições ou dos arquivos enviados?

A Política de Privacidade e as informações sobre suboperadores descrevem como os prestadores de serviço tratam os dados e quais medidas de proteção se aplicam. Analise esses documentos e qualquer contrato aplicável à sua conta ao avaliar onde seus dados são tratados.

[Política de Privacidade →](https://www.genderapi.io/pt/privacy-policy)[Suboperadores →](https://www.genderapi.io/pt/subprocessors)[Informações sobre o GDPR →](https://www.genderapi.io/pt/gdpr-compliance)

## Conecte suas chaves e gerencie sua conta

Acesso gratuito, autenticação, consulta de saldo e suporte.

### Posso testar a GenderAPI gratuitamente?

Sim. Uma conta gratuita cadastrada inclui 200 créditos por dia. Independentemente disso, o teste por IP da V2 sem chave oferece 10 créditos por endereço IP público a cada 24 horas, compartilhados com a V1 e com os demais usuários do mesmo endereço IP. Em ambos os casos, aplicam-se os custos normais; o número de créditos nem sempre corresponde ao número de requisições HTTP.

[Plano gratuito e preços →](https://www.genderapi.io/pt/price)[Teste por IP →](https://www.genderapi.io/pt/docs/v2/authentication)

### Como me autentico e protejo minha chave de API?

Use Authorization: Bearer YOUR_API_KEY em código confiável do lado do servidor; as requisições POST também exigem Content-Type: application/json. Mantenha a chave real fora do código do navegador, de repositórios públicos e dos logs. Chaves ausentes, com formato inválido ou não reconhecidas podem levar ao teste por IP; por isso, verifique se meta.access.mode tem o valor api_key. Chaves reconhecidas, mas desativadas, expiradas ou restritas não passam para o teste.

[Autenticação na V2 →](https://www.genderapi.io/pt/docs/v2/authentication)

### Como consulto meus créditos restantes?

Chame GET /api/v2/usage com sua chave Bearer. Essa consulta de saldo é gratuita e retorna data.remaining_credits. Sem chave, é lido o saldo compartilhado do teste por IP. A V1 e a V2 usam o mesmo saldo da conta; o valor remaining_credits em uma previsão indica o saldo no momento em que a operação foi concluída.

[Saldo e uso →](https://www.genderapi.io/pt/docs/v2/credits-and-usage)

### Onde posso gerenciar ou cancelar uma assinatura?

Entre na aplicação da GenderAPI para gerenciar a assinatura vinculada à sua chave de API. Nas configurações atuais da conta, você encontra seu pacote e as opções de cancelamento.

[Abrir sua conta da GenderAPI →](https://app.genderapi.io/)

### Onde posso alterar meus dados de cobrança?

As configurações de cobrança e pagamento são gerenciadas depois do login na aplicação da GenderAPI, para cada chave de API ou assinatura.

[Abrir sua conta da GenderAPI →](https://app.genderapi.io/)

### Como informo um resultado incorreto ou recebo ajuda com uma integração?

Envie ao suporte a versão da API, o endpoint, o request_id e um exemplo curto e reproduzível. Informe o código de erro, se houver, mas remova sua chave de API e os dados pessoais sensíveis.

[Enviar e-mail ao suporte →](mailto:support@genderapi.io)

## Guias de implementação e uso responsável

Respostas sobre resultados, privacidade e funcionamento da V2, com links para os guias e uma versão em Markdown de cada resposta.

### Resultados, confiança e uso responsável

Uma previsão V2 não resolvida retorna em gender o valor null nativo do JSON, não a string "null". Um nome pode ser ambíguo ou os sinais disponíveis podem não ser suficientes; verifique result_status e reason quando estiverem presentes. Preserve o resultado desconhecido em vez de forçá-lo a uma categoria. Uma previsão bem-sucedida sem resultado é cobrada conforme o custo do modo escolhido. Erros da requisição ou do provedor são casos de erro distintos; os detalhes sobre a cobrança correspondente estão em meta.usage.

Uma avaliação de precisão significativa informa a população analisada, a data, o método de amostragem, a proporção de resultados desconhecidos e os resultados por região e sistema de escrita. A página atual sobre a metodologia descreve um protocolo de avaliação, não um valor de precisão medido em porcentagem. Os campos confidence e confidence_kind da V2 explicam em quais sinais um resultado se baseia; eles não substituem uma avaliação com dados representativos.

- [Por que um resultado é ambíguo ou desconhecido?Uma previsão V2 não resolvida retorna em gender o valor null nativo do JSON, não a string "null". Um nome pode ser ambíguo ou os sinais disponíveis podem não ser suficientes; verifique result_status e reason quando estiverem presentes. Preserve o resultado desconhecido em vez de forçá-lo a uma categoria. Uma previsão bem-sucedida sem resultado é cobrada conforme o custo do modo escolhido. Erros da requisição ou do provedor são casos de erro distintos; os detalhes sobre a cobrança correspondente estão em meta.usage.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/ambiguous-and-unknown-name-results)
- [Como a precisão da GenderAPI é avaliada?Uma avaliação de precisão significativa informa a população analisada, a data, o método de amostragem, a proporção de resultados desconhecidos e os resultados por região e sistema de escrita. A página atual sobre a metodologia descreve um protocolo de avaliação, não um valor de precisão medido em porcentagem. Os campos confidence e confidence_kind da V2 explicam em quais sinais um resultado se baseia; eles não substituem uma avaliação com dados representativos.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/how-accuracy-is-measured)

### Fontes de dados, privacidade e conformidade

A página sobre a procedência dos dados descreve a estrutura para documentar categorias de fontes, critérios de seleção, licenças e limites geográficos e de sistemas de escrita. No momento, ela não traz uma lista verificada de fontes. Leia essa página e entre em contato com o suporte se a sua integração tiver requisitos relacionados às fontes; não presuma fontes, tamanhos do conjunto de dados ou valores de cobertura que não estejam documentados.

A página atual sobre a procedência dos dados não indica um calendário de atualização único para todos os registros de nomes ou regras de processamento. Se a atualidade dos dados for importante para o seu caso de uso, pergunte ao suporte sobre o conjunto de dados ou o processo em questão e teste resultados representativos. A data de revisão de uma página não indica que todos os registros subjacentes foram atualizados nesse dia.

A Política de Privacidade, as informações sobre o GDPR, o Acordo de Processamento de Dados e a lista de suboperadores descrevem as condições de tratamento publicadas e as medidas de proteção. Analise os documentos atualizados e qualquer contrato aplicável à sua conta. Para dúvidas específicas da sua organização, por exemplo sobre papéis no tratamento, transferências de dados ou solicitações de titulares, entre em contato com a GenderAPI; uma FAQ geral não substitui o contrato em vigor.

- [Como as fontes de dados de nomes são selecionadas?A página sobre a procedência dos dados descreve a estrutura para documentar categorias de fontes, critérios de seleção, licenças e limites geográficos e de sistemas de escrita. No momento, ela não traz uma lista verificada de fontes. Leia essa página e entre em contato com o suporte se a sua integração tiver requisitos relacionados às fontes; não presuma fontes, tamanhos do conjunto de dados ou valores de cobertura que não estejam documentados.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/how-name-data-sources-are-selected)
- [Com que frequência os dados de nomes são atualizados?A página atual sobre a procedência dos dados não indica um calendário de atualização único para todos os registros de nomes ou regras de processamento. Se a atualidade dos dados for importante para o seu caso de uso, pergunte ao suporte sobre o conjunto de dados ou o processo em questão e teste resultados representativos. A data de revisão de uma página não indica que todos os registros subjacentes foram atualizados nesse dia.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/how-often-name-data-is-updated)
- [Onde encontro informações sobre o GDPR e o acordo de processamento de dados?A Política de Privacidade, as informações sobre o GDPR, o Acordo de Processamento de Dados e a lista de suboperadores descrevem as condições de tratamento publicadas e as medidas de proteção. Analise os documentos atualizados e qualquer contrato aplicável à sua conta. Para dúvidas específicas da sua organização, por exemplo sobre papéis no tratamento, transferências de dados ou solicitações de titulares, entre em contato com a GenderAPI; uma FAQ geral não substitui o contrato em vigor.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/genderapi-gdpr-and-dpa)

### Funcionamento da API, erros e cobrança

Use Authorization: Bearer YOUR_API_KEY em código confiável do lado do servidor. As requisições POST da V2 também exigem Content-Type: application/json. GET /api/v2/gender também aceita a chave como parâmetro de consulta, mas os cabeçalhos evitam que as credenciais apareçam em URLs do navegador. Chaves ausentes, com formato inválido ou não reconhecidas podem levar ao teste por IP compartilhado; em uma integração com conta, verifique se meta.access.mode tem o valor api_key. Chaves reconhecidas, mas desativadas, expiradas ou restritas não passam para um teste.

A V2 aplica limites ao número de requisições e às requisições simultâneas; trate o HTTP 429 e o Retry-After. Cada previsão repetida é uma nova operação e é cobrada normalmente. Não repita requisições automaticamente após um tempo limite esgotado, uma resposta perdida ou uma cobrança não confirmada. Verifique primeiro code, action e meta.usage.billing_status; em caso de billing_reconciliation_required, entre em contato com o suporte informando o request_id. Use um backoff limitado apenas quando a cobrança estiver confirmada e a action documentada permitir uma nova tentativa.

Os erros da API V2 usam códigos de status HTTP de erro e Problem Details conforme a RFC 9457, com os campos estáveis code e action. Baseie-se nesses campos em vez de comparar o texto de detail e guarde o request_id para o suporte. Um resultado desconhecido bem-sucedido não é um erro. As respostas de lote podem conter erros em itens individuais mesmo com HTTP 200. Um proxy pode retornar um erro em um formato diferente de JSON, e uma resposta perdida ou ilegível não comprova que nenhum crédito foi cobrado.

Chame GET /api/v2/usage com sua chave de API no cabeçalho Bearer a partir de código confiável do lado do servidor. Essa requisição é gratuita e retorna data.remaining_credits; sem chave, é lido o saldo do teste por IP compartilhado. A V1 e a V2 usam o mesmo saldo da conta. O campo meta.usage de uma previsão indica o custo dessa operação e o saldo no momento em que ela foi concluída, que pode mudar com requisições simultâneas. Mantenha as credenciais fora dos logs e não considere uma consulta de saldo como prova de que uma determinada requisição com resposta perdida não foi cobrada.

Crie as novas integrações com a V2 e deixe que os clientes V1 existentes usem seus endpoints documentados até que você queira migrar para a V2. As duas versões usam as mesmas chaves de API e os mesmos créditos, mas diferem nos campos da requisição, na estrutura das respostas e no formato dos erros. Siga o guia de migração, teste resultados bem-sucedidos, desconhecidos e erros, e adapte o tratamento das respostas antes de trocar de endpoint. A documentação da V1 continua disponível para as integrações existentes.

Quando as requisições falharem, use o código de erro retornado para distinguir entre falhas do serviço, entradas inválidas, problemas de acesso à conta, créditos esgotados e limites de requisições. Monitore a proporção de requisições bem-sucedidas e os tempos de resposta na sua integração. Entre em contato com o suporte informando o request_id em caso de erro inexplicável ou cobrança pouco clara. Baseie as afirmações sobre disponibilidade em medições; esta FAQ não indica nenhum valor de disponibilidade garantido em porcentagem.

- [Como autentico as requisições V2?Use Authorization: Bearer YOUR_API_KEY em código confiável do lado do servidor. As requisições POST da V2 também exigem Content-Type: application/json. GET /api/v2/gender também aceita a chave como parâmetro de consulta, mas os cabeçalhos evitam que as credenciais apareçam em URLs do navegador. Chaves ausentes, com formato inválido ou não reconhecidas podem levar ao teste por IP compartilhado; em uma integração com conta, verifique se meta.access.mode tem o valor api_key. Chaves reconhecidas, mas desativadas, expiradas ou restritas não passam para um teste.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/how-to-authenticate-api-requests)
- [Como lido com limites de requisições e novas tentativas?A V2 aplica limites ao número de requisições e às requisições simultâneas; trate o HTTP 429 e o Retry-After. Cada previsão repetida é uma nova operação e é cobrada normalmente. Não repita requisições automaticamente após um tempo limite esgotado, uma resposta perdida ou uma cobrança não confirmada. Verifique primeiro code, action e meta.usage.billing_status; em caso de billing_reconciliation_required, entre em contato com o suporte informando o request_id. Use um backoff limitado apenas quando a cobrança estiver confirmada e a action documentada permitir uma nova tentativa.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/rate-limits-and-retries)
- [Como interpreto os erros da V2?Os erros da API V2 usam códigos de status HTTP de erro e Problem Details conforme a RFC 9457, com os campos estáveis code e action. Baseie-se nesses campos em vez de comparar o texto de detail e guarde o request_id para o suporte. Um resultado desconhecido bem-sucedido não é um erro. As respostas de lote podem conter erros em itens individuais mesmo com HTTP 200. Um proxy pode retornar um erro em um formato diferente de JSON, e uma resposta perdida ou ilegível não comprova que nenhum crédito foi cobrado.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/api-error-codes)
- [Como consulto os créditos restantes?Chame GET /api/v2/usage com sua chave de API no cabeçalho Bearer a partir de código confiável do lado do servidor. Essa requisição é gratuita e retorna data.remaining_credits; sem chave, é lido o saldo do teste por IP compartilhado. A V1 e a V2 usam o mesmo saldo da conta. O campo meta.usage de uma previsão indica o custo dessa operação e o saldo no momento em que ela foi concluída, que pode mudar com requisições simultâneas. Mantenha as credenciais fora dos logs e não considere uma consulta de saldo como prova de que uma determinada requisição com resposta perdida não foi cobrada.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/check-credits-and-quota)
- [Como migro da V1 para a V2 sem interrupções?Crie as novas integrações com a V2 e deixe que os clientes V1 existentes usem seus endpoints documentados até que você queira migrar para a V2. As duas versões usam as mesmas chaves de API e os mesmos créditos, mas diferem nos campos da requisição, na estrutura das respostas e no formato dos erros. Siga o guia de migração, teste resultados bem-sucedidos, desconhecidos e erros, e adapte o tratamento das respostas antes de trocar de endpoint. A documentação da V1 continua disponível para as integrações existentes.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/api-versioning-and-breaking-changes)
- [Como identifico erros e monitoro a disponibilidade do serviço?Quando as requisições falharem, use o código de erro retornado para distinguir entre falhas do serviço, entradas inválidas, problemas de acesso à conta, créditos esgotados e limites de requisições. Monitore a proporção de requisições bem-sucedidas e os tempos de resposta na sua integração. Entre em contato com o suporte informando o request_id em caso de erro inexplicável ou cobrança pouco clara. Baseie as afirmações sobre disponibilidade em medições; esta FAQ não indica nenhum valor de disponibilidade garantido em porcentagem.Leia a resposta completa →](https://www.genderapi.io/pt/frequently-asked-questions/service-status-and-uptime)

## Envie um exemplo que possamos reproduzir

Informe o endpoint, os parâmetros da requisição e o erro retornado, mas não envie sua chave de API de produção nem dados pessoais sensíveis.

- [Enviar e-mail ao suporte](mailto:support@genderapi.io)
- [Consultar os erros da V2](https://www.genderapi.io/pt/docs/v2/errors-and-retries)