💡 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:

  1. O token deve ser enviado como parâmetro na URL da requisição.
  2. 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

NomeTipoObrigatórioDescrição
CURPstringSimCódigo de Registro de População Única. Pode ser enviado com ou sem formatação.
TOKENstringSimToken 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ódigoDescrição
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
403Não autorizado: saldo insuficiente para realizar a consulta.
404Não encontrado: registro não localizado.
408Tempo esgotado: consulta não foi concluída no prazo.
500Erro interno: falha no processamento da consulta.
503Serviço em manutenção: indisponível temporariamente.