Информация для разработчиков по ПДн

Что потребуется для подключения

Перед интеграцией убедитесь, что в личном кабинете Soglasius создан проект типа personal_data.

• project_id — идентификатор проекта в формате S-XXXXXX.
• license_key — ключ проекта. Он нужен только для серверных запросов.
• Основной домен и дополнительные разрешенные домены должны быть добавлены в настройках проекта.
• Активная версия согласия должна быть загружена и опубликована в разделе настроек ПДн.

Какие API использовать

Для фиксации согласия используйте endpoint /api/v1/sendConsent/. Он валидирует запрос, формирует запись согласия и сохраняет ее в хранилище.

Endpoint

Авторизация

Если запрос отправляется из браузера с разрешенного домена, ключ проекта передавать не нужно: домен определяется по заголовкам Origin или Referer.

Если запрос отправляется с сервера, передайте заголовки:

X-Auth-Token: YOUR_LICENSE_KEY
X-Domain: example.ru
Content-Type: application/json

Не размещайте license_key в публичном JavaScript-коде сайта.

Тело запроса

{
  "type": "personal_data",
  "project_id": "S-ABC123",
  "data": {
    "purposes": ["registration", "feedback"],
    "categories": {
      "full_name": "Иван Иванов",
      "email": "ivan@example.ru",
      "phone": "+7 900 000-00-00"
    },
    "processing_actions": ["collection", "storage", "use"]
  }
}

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

await fetch('https://soglasius.ru/api/v1/sendConsent/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'personal_data',
    project_id: 'S-ABC123',
    data: {
      purposes: ['registration', 'feedback'],
      categories: {
        full_name: 'Иван Иванов',
        email: 'ivan@example.ru'
      },
      processing_actions: ['collection', 'storage', 'use']
    }
  })
});

Пример серверного запроса

curl -X POST "https://soglasius.ru/api/v1/sendConsent/" \
  -H "Content-Type: application/json" \
  -H "X-Auth-Token: YOUR_LICENSE_KEY" \
  -H "X-Domain: example.ru" \
  -d '{
    "type": "personal_data",
    "project_id": "S-ABC123",
    "data": {
      "purposes": ["registration"],
      "categories": {
        "email": "ivan@example.ru"
      },
      "processing_actions": ["collection", "storage", "use"]
    }
  }'

Корневые поля

Поля объекта data

Согласие и отказ

Если пользователь дал согласие, передайте в categories хотя бы одну выбранную категорию.

Если пользователь отказался от обработки персональных данных, передайте пустой объект categories. Такой запрос фиксируется как отказ.

{
  "type": "personal_data",
  "project_id": "S-ABC123",
  "data": {
    "purposes": ["feedback"],
    "categories": {},
    "processing_actions": ["collection", "storage"]
  }
}

Как используются значения категорий

Сервис не хранит исходные значения персональных данных в составе согласия. Значения используются для формирования user_hash, по которому можно сопоставить согласие с пользователем без хранения исходных данных.

Для email удаляются пробелы, для phone остаются только цифры, для full_name и address лишние пробелы сворачиваются. Все строковые значения приводятся к нижнему регистру и обрезаются по краям.

Поля ip_address и user_agent, если переданы, используются как технические метаданные записи согласия. Они не должны быть единственными данными для сопоставления согласия с пользователем.

Цели обработки: purposes

Категории персональных данных: categories

Действия с персональными данными: processing_actions