Migração de IDs para IDs de Objeto

Fizemos a transição para IDs de Objeto em todas as entidades. Esta mudança melhora a legibilidade, permite a geração independente de IDs entre serviços e garante unicidade em escala.

O que são IDs de Objeto?

IDs de Objeto são identificadores únicos com um prefixo que indica o tipo de entidade. Em vez de um ID genérico como 12345 ou um UUID, você obtém algo como:

em_48klx31D1jqAfDcG53R8y1j1XbP

O prefixo em_ indica imediatamente que se trata de uma entidade de email.

Vantagens

• Legível — Identifique o tipo de entidade de relance
• Único — Sem conflitos entre serviços
• Ordenado — IDs são classificáveis por horário de criação
• Escalável — Gerados independentemente sem coordenação de banco de dados

Prefixos de entidades

• Audiências — aud_
• Campanhas — cmp_
• Cliques — click_
• Contatos — con_
• Credenciais — key_
• Campos Personalizados — cf_
• Entregas — del_
• Emails — em_
• Eventos — evt_
• Arquivos — file_
• Links — link_
• Carregamentos — load_
• Emails na Fila — que_
• Domínios — dom_
• Assinantes — sub_
• Supressões — sup_
• Descadastros — uns_
• Requisições de Webhook — whr_
• Webhooks — wh_

Migração concluída

Migramos mais de 1,5 bilhão de registros para o novo formato de ID de Objeto. Todas as respostas da API v2 agora retornam IDs de Objeto para as entidades listadas acima.