Migramos os IDs para Object IDs

Passamos a usar Object IDs em todas as entidades. A mudança melhora a legibilidade, permite gerar IDs de forma independente em cada serviço e garante que eles sejam únicos em escala.

O que são Object IDs?

Object IDs 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ê recebe algo assim:

em_48klx31D1jqAfDcG53R8y1j1XbP

O prefixo em_ mostra na hora que se trata de uma entidade de e-mail.

Vantagens

• Legíveis: você reconhece o tipo de entidade de relance
• Únicos: sem colisões entre serviços
• Ordenados: os IDs podem ser ordenados pela data de criação
• Escaláveis: gerados de forma independente, sem coordenação com o banco de dados

Prefixos das entidades

• Listas de contatos (audiences): aud_
• Campanhas: cmp_
• Cliques: click_
• Contatos: con_
• Credenciais: key_
• Campos personalizados: cf_
• Entregas: del_
• E-mails: em_
• Eventos: evt_
• Arquivos: file_
• Links: link_
• Carregamentos: load_
• E-mails na fila: que_
• Domínios: dom_
• Inscritos: 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 Object ID. Todas as respostas da API v2 agora retornam Object IDs para as entidades listadas acima.