POST /api/v1/analytics/identify/public

Vincula um anonymousId a um userId e persiste traits (atributos) do usuário. Versão pública do /identify, autenticada por API Key — pode ser chamada do browser ou app móvel.

Autenticação

API Key.

Headers

Header	Valor
Authorization	Bearer <sua-key>
Content-Type	application/json

Body

Campo	Tipo	Obrigatório	Descrição
anonymousId	string	Sim	Identificador anônimo do visitante
userId	string | null	Não	ID do usuário autenticado a vincular ao anonymousId
sessionId	UUID	Não	Sessão atual; se omitida, resolvida automaticamente
traits	object	Não	Atributos do usuário (email, firstName, plan, ...)
context	SegmentContext	Não	Contexto de ambiente

Se você enviar anonymousId sem userId, o endpoint apenas registra os traits no perfil anônimo. Para criar o vínculo identidade → usuário, envie userId.

Exemplo de requisição

curl -X POST https://api-crm.ecommerceapp.com.br/api/v1/analytics/identify/public \
  -H "Authorization: Bearer SUA-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "anonymousId": "anon-7c1f3a",
    "userId": "user-9182"
  }'

Resposta

200 OK

{
  "success": true,
  "session": {
    "sessionId": "01J9XK8E7G5R3M2N4P6Q8S0T1V",
    "isNew": false
  }
}

Quando chamar

• Imediatamente após login bem-sucedido do usuário.
• Após cadastro (sign-up).

Erros

Status	Causa
400 Bad Request	Body inválido
401 Unauthorized	API Key inválida ou ausente