VARICA
digital proposal bureau
VARICA / Документация v2

Обновление результата по сущности

Привязывает внешний результат к уже созданным страницам по source_entity_id и обновляет статус результата у всех связанных страниц.

МетодPOST Endpoint/api/v2/entity-results АвторизацияX-Api-Key Входapplication/json Выходapplication/json
01 / Раздел

Назначение

Метод нужен для второго шага интеграции: после создания страницы внешняя система сообщает, какой результат получен по сущности.

Сервис ищет все страницы организации с тем же source_entity_id и обновляет им result_status.

02 / Раздел

Поля

  • `source_entity_id` - обязательное поле, ID сущности во внешней системе.
  • `result` - обязательное поле, одно из значений: `unknown`, `success`, `not_implemented`.
03 / Раздел

Пример запроса

JSON
{
  "source_entity_id": "9999999",
  "result": "success"
}
04 / Раздел

Пример ответа

JSON
{
  "source_entity_id": "9999999",
  "result": "success",
  "updated_pages": 2,
  "page_ids": [48, 52]
}
05 / Раздел

Поведение

  • Если страницы по source_entity_id найдены, статус обновляется у всех страниц этой организации.
  • Если страницы не найдены, метод не падает и возвращает updated_pages = 0.
  • Метод не создаёт новых страниц и не запускает внешние процессы.