Работа с персональными и чувствительными данными
Статья обновлена November 12, 2026
Передавайте в API только данные, необходимые для задачи пользователя. Обрабатывайте полный ответ в клиенте и выбирайте поля, которые нужны для следующего вызова или ответа пользователю.
Какие данные учитывать
| Данные | Примеры |
|---|---|
| Сведения о человеке | ФИО, телефон, личная почта, домашний адрес, идентификаторы учётной записи и документов |
| Сведения о заказах и организациях | Цены и ставки, ИНН, внутренние идентификаторы, адреса складов, точные координаты и маршруты |
| Данные аутентификации | Токены, пароли, содержимое заголовка Authorization |
Комментарии, вложения и другие поля произвольного формата могут содержать данные из любой строки таблицы. Сверяйте правила для конкретных полей в разделе «Работа с чувствительными данными» карточки метода. Если карточка не описывает условия раскрытия нужного поля, оставляйте исходное значение в клиенте.
Перед вызовом API
- Уточните цель запроса и проверьте доступ к нужной организации и операции.
- Передайте обязательные поля и те необязательные поля, которые нужны для задачи. Например, для поиска координат достаточно адреса. Уберите из запроса имена, телефоны и комментарии к заказу.
- Для токенов используйте согласованный источник секретов. Значения остаются в среде выполнения клиента.
При обработке ответа
- Оставляйте полные ответы и вложения в клиенте. Для следующего вызова передавайте только нужные поля. Идентификатор заказа можно использовать в запросе деталей внутри клиента, а пользователю показать статус заказа.
- По умолчанию пропускайте чувствительные значения, маскируйте их или сообщайте итог. Для проверки профиля сотрудника достаточно сообщить, найден ли профиль и доступна ли нужная роль.
- Передавайте исходное значение пользователю, в контекст ИИ или во внешнюю систему, только если карточка метода разрешает передачу по этому каналу, пользователь явно запросил её, значение необходимо для задачи и у получателя есть действующий доступ. Если получатель или цель неясны, уточните их до передачи. Данные аутентификации не раскрывайте.
- Если нужно сохранить результат вне клиента, согласуйте с пользователем состав данных, место хранения и доступ к нему. Сохраняйте только поля, необходимые для задачи.
При диагностике и тестировании
Исключите исходные чувствительные значения из журналов, трассировок, метрик, сообщений об ошибках и материалов для поддержки. Сообщайте стенд, метод, HTTP-статус и какие шаги удалось выполнить. Для тестов и примеров используйте синтетические значения.
Предыдущая