Миграция идентификаторов на Object ID

Мы перешли на 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 для перечисленных выше сущностей.