💡 A API Registration Data - México retorna informações detalhadas de cadastro associadas ao Código de Registro de População Única do México (CURP). É ideal para validação de identidade e cadastro em serviços no México.
Introdução
A API Registration Data - México é projetada para retornar dados pessoais, de contato e informações demográficas relacionadas ao CURP. Ela é amplamente utilizada para evitar fraudes e facilitar o onboarding de usuários em sistemas que exigem validação de identidade.
URL Base
A API está hospedada no seguinte endereço:
https://api.directd.com.br
Endpoint
Consulta de Cadastro no México
GET /api/RegistrationDataMexico
Descrição: Endpoint para realizar consultas utilizando o CURP.
Nota: Este endpoint não gera comprovantes.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
Campos da API
Informações Cadastrais
- Name: Nome completo da pessoa.
- Date of Birth: Data de nascimento no formato ISO (YYYY-MM-DD).
- Gender: Gênero da pessoa.
- Age: Idade estimada.
- CURP: Código de Registro de População Única do México.
- RFC: Registro Federal de Contribuintes.
Informações de Contato
- Phones:
- Phone Number: Número do telefone com código de área.
- Phone Type: Tipo de telefone (fixo, celular, etc.).
- Addresses:
- Street: Nome da rua.
- Number: Número do endereço.
- Complement: Complemento do endereço.
- Neighborhood: Bairro.
- City: Cidade.
- State: Estado.
- Postal Code: Código postal.
- Emails:
- Email Address: Endereço de e-mail.
Informações Financeiras
- Salary Range: Faixa salarial estimada.
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CURP | string | Sim | Código de Registro de População Única. Pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
Exemplos de Requisição
Consulta por CURP:
curl 'https://api.directd.com.br/api/RegistrationDataMexico?CURP=ABCDEFGHIJKLMN123&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "Registration Data - México",
"consultaUid": "regDataMexico-123456",
"usuario": "Maria Gonzalez",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 200
},
"retorno": {
"name": "MARIA GONZALEZ",
"dateOfBirth": "1990-05-10",
"gender": "Feminino",
"age": 34,
"phones": [
{
"phoneNumber": "(55) 1234-5678",
"phoneType": "Celular"
}
],
"addresses": [
{
"street": "Av. Revolución",
"number": "456",
"complement": "Apto 301",
"neighborhood": "Centro",
"city": "Cidade do México",
"state": "CDMX",
"postalCode": "12345"
}
],
"emails": [
{
"emailAddress": "maria.gonzalez@email.com"
}
],
"salaryRange": "Entre 10.000 e 15.000 MXN",
"curp": "ABCDEFGHIJKLMN123",
"rfc": "GONM901005"
}
}
Erros Comuns
Código | Descrição |
---|---|
400 | Requisição inválida: parâmetros incorretos. |
401 | Não autenticado: token inválido ou ausente. |
403 | Não autorizado: saldo insuficiente para realizar a consulta. |
404 | Não encontrado: registro não localizado. |
408 | Tempo esgotado: consulta não foi concluída no prazo. |
500 | Erro interno: falha no processamento da consulta. |
503 | Serviço em manutenção: indisponível temporariamente. |