Skip to content

Enriquecer pessoa (individual)

Request

Enriquece perfil de pessoa física individualmente com processamento assíncrono.

Parâmetros de entrada (pelo menos um é obrigatório): url_linkedin, email, cpf ou id_pessoa.

Custo: 1 crédito por registro enriquecido com sucesso

Dados retornados:

  • Básicos: nome completo, CPF (quando disponível), idade, gênero, localização
  • Contatos: telefones, emails (com status_email validado), perfis públicos
  • Vínculos empresariais: participações, cargos corporativos, CNPJs
  • Histórico profissional: cargos, empresas, períodos
  • Educação: cursos, instituições, níveis de escolaridade

A notificação de conclusão é enviada via webhook (se configurado).

Security
ApiKeyAuth
Bodyapplication/jsonrequired
contatoobject
url_webhookstring

URL para notificação de conclusão

Example:"https://seusite.com/webhook"
curl -i -X POST \
  https://docs.datastone.com.br/_mock/api/b2b/persons/enrich \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "contato": {
      "url_linkedin": "https://www.linkedin.com/in/exemplo",
      "email": "exemplo@empresa.com",
      "cpf": "12345678901",
      "id_pessoa": 12345
    },
    "url_webhook": "https://seusite.com/webhook"
  }'

Responses

Processamento enfileirado com sucesso

Bodyapplication/json
sucessoboolean

Status de sucesso

Example:true
mensagemstring

Mensagem descritiva

Example:"Processamento de 1 pessoa(s) enfileirado com sucesso."
id_processamentostring

ID único do processamento (UUID hex)

Example:"4cb319e3bd9544019b45fd56911fa160"
quantidadeinteger

Quantidade de contatos enfileirados

Example:1
url_webhookstring

URL do webhook que será notificado

Example:"https://seusite.com/webhook"
Response
{
  "sucesso": true,
  "mensagem": "Processamento de 1 pessoa(s) enfileirado com sucesso.",
  "id_processamento": "4cb319e3bd9544019b45fd56911fa160",
  "quantidade": 1,
  "url_webhook": "https://seusite.com/webhook"
}

Callbacks

Webhook de conclusão do enriquecimento de pessoa
post