Перейти к основному содержанию
POST
curl
Примечание содержит контекст, а не решение: оно никогда не меняет status, score или оповещения транзакции. Проверяющие видят его в разделе Примечания на странице сведений о транзакции в Console, а в activities транзакции появляется запись TRANSACTION_NOTE_ADDED, которую можно прочитать с помощью Получить транзакцию. Поскольку примечание создано с помощью API-ключа, оно не содержит автора: actor_email и actor_name равны null. Если нужно показать, кто его написал, укажите это в тексте примечания. Полную хронологию можно получить с помощью Получить список примечаний к транзакции.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

transaction_id
string<uuid>
обязательно

UUID транзакции Didit: значение uuid, возвращаемое методами POST /v3/transactions/ и GET /v3/transactions/. Собственный txn_id не принимается.

Тело

application/json
note
string
обязательно

Обычная текстовая заметка. Пробелы в начале и в конце удаляются, а пустая заметка отклоняется. Без ограничений по длине.

Minimum string length: 1
mentioned_emails
string<email>[]

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

Ответ

Заметка создана.

Одна заметка в хронологии проверки отслеживаемой транзакции.

uuid
string<uuid>
обязательно

Идентификатор заметки.

note
string
обязательно

Текст обычной заметки.

actor_email
string<email> | null
обязательно

Электронная почта пользователя Console, оставившего заметку или изменившего статус. null для заметок, созданных с помощью API-ключа, и заметок, добавляемых Didit автоматически.

actor_name
string | null
обязательно

Отображаемое имя пользователя Console (его email, если имя не указано). Rule Engine для заметок, которые Didit добавляет автоматически. null для заметок, созданных с помощью API-ключа.

metadata
object
обязательно

Различает типы заметок. Заметки, добавленные через API или консоль, содержат mentioned_emails. Изменение статуса, сделанное в консоли, содержит type: status_change с previous_status, new_status, reason_code и reason_label. Заметки, добавленные Didit, содержат source: rule_action (с rule_uuid) для действия правила add_note или remediation_session для проблемы при создании сессии верификации по действию пользователя.

created_at
string<date-time>
обязательно

Время сохранения заметки.

Последнее изменение 7 ноября 2026 г.