Переиндексация записей (REST API)

Эндпоинт /v2/data/atomic/reindex (метод POST) предназначен для переиндексации указанных записей, а также их связей и классификаций. Запрос позволяет передать список дополнительных записей для переиндексации, используя единый bulk‑пайплайн операции реиндексации.

Структура запроса (request body)

record-reindex-fragment-v2

Поле	Тип	Описание
records	array	Обязательное. Список записей для переиндексации (см. структуру элемента ниже).
reindexRelations	boolean	Если true – будут переиндексированы связи всех указанных записей.
reindexRecord	boolean	Deprecated. Всегда true. Будет удалено.
etalonId, entityName, externalId, lsn		Deprecated. Используйте поле records. (Эти поля будут удалены)

Элемент списка ``records``

Поле	Тип	Описание
etalonId	string	Etalon ID записи.
entityName	string	Имя сущности (реестра или справочника).
externalId	object	Внешний идентификатор записи.
lsn	object	LSN (Log Sequence Number) записи.

classification-reindex-fragment-v1

Поле	Тип	Описание
reindexClassification	boolean	Если true – будут переиндексированы классификации всех указанных записей.
etalonId, entityName, externalId, lsn		Deprecated. Классификация переиндексируется только вместе с самой записью.

Рекомендованный формат запроса

В актуальной версии следует использовать только поля records, reindexRelations и reindexClassification.

Пример минимального тела запроса:

{
"payload": {
"classification-reindex-fragment-v1": {
 "reindexClassification": true
},
"record-reindex-fragment-v2": {
 "reindexRelations": true,
 "records": [
   {
     "etalonId": "string",
     "entityName": "string",
     "externalId": {
       "externalId": "string",
       "sourceSystem": "string"
     },
     "lsn": {
       "lsn": 0,
       "shard": 0
       }
     }
   ]
  }
 }
}

Пример: переиндексация двух записей, их связей и классификаций.

Важные замечания

• Классификация записи не может быть переиндексирована без самой записи. Поля etalonId, entityName, externalId и lsn в блоке classification-reindex-fragment-v1 игнорируются и будут удалены.

• Флаг reindexRecord всегда имеет значение true; его передача необязательна.

• Эндпоинт теперь использует bulk-пайплайн операции реиндексации.