Міграція ідентифікаторів до об'єктних ідентифікаторів

Ми перейшли на Object ID для всіх сутностей. Ця зміна покращує читабельність, дозволяє незалежно генерувати ідентифікатори в різних сервісах і забезпечує унікальність у великих масштабах.

Що таке Object ID?

Object ID — це унікальні ідентифікатори з префіксом, який вказує на тип сутності. Замість звичайного ID на кшталт 12345 або UUID, ви отримуєте щось таке:

em_48klx31D1jqAfDcG53R8y1j1XbP

Префікс em_ одразу показує, що це сутність електронного листа.

Переваги

• Читабельність — визначте тип сутності з першого погляду
• Унікальність — жодних конфліктів між сервісами
• Впорядкованість — ID можна сортувати за часом створення
• Масштабованість — генеруються незалежно без координації з базою даних

Префікси сутностей

• Аудиторії — aud_
• Кампанії — cmp_
• Кліки — click_
• Контакти — con_
• Облікові дані — key_
• Користувацькі поля — cf_
• Доставки — del_
• Електронні листи — em_
• Події — evt_
• Файли — file_
• Посилання — link_
• Завантаження — load_
• Листи в черзі — que_
• Домени — dom_
• Підписники — sub_
• Блокування — sup_
• Відписки — uns_
• Webhook-запити — whr_
• Webhook'и — wh_

Міграція завершена

Ми перенесли понад 1,5 мільярда записів у новий формат Object ID. Усі відповіді API v2 тепер повертають Object ID для перелічених вище сутностей.