Добавление профилей в базу данных

API-эндпоинт для добавления профилей в базу данных

Для добавления профилей в вашу базу данных предусмотрен API-эндпоинт, к которому софт обращается методом POST. Передача данных осуществляется в формате JSON.

Передаваемые параметры

Параметр	Тип	Описание
profile_id	string/int	Уникальный идентификатор профиля.
cookies_data	string (base64)	Куки профиля в формате JSON, закодированные в base64.
fingerprint	string	Отпечатки профиля в формате BAS.
group	string	Название или идентификатор группы профилей.
local_storage	string (base64)	Данные локального хранилища, закодированные в base64.
proxy	string	Прокси, закреплённый за профилем.
tags	string	Теги профиля, разделённые запятыми.
useragent	string	User-Agent профиля.
ya_serp_visits	int	Количество посещений поисковой выдачи Яндекса.
device_type	string	Тип устройства: mobile или desktop.
domains_in_cookies	int	Количество доменов, содержащихся в cookies.
geolocation	string	Установленная геолокация для Яндекса.

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

{
  "profile_id": "12345",
  "cookies_data": "eyJ5YW5kZXg...==",
  "fingerprint": "BAS_fingerprint_data",
  "group": "promo_group_1",
  "local_storage": "ZXhhbXBsZQ==",
  "proxy": "192.168.0.1:8080",
  "tags": "main,seo,ya",
  "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
  "ya_serp_visits": 42,
  "device_type": "desktop",
  "domains_in_cookies": 15,
  "geolocation": "Moscow"
}

Обработка данных

Вы можете обрабатывать и сохранять эти данные в любой удобной структуре — в зависимости от вашей архитектуры и используемой СУБД. При необходимости добавляйте дополнительные поля, например:

• create_date — дата создания профиля,

• clicks_on_target_site — количество кликов по целевым сайтам,

• clicked_target_sites — список посещённых целевых сайтов,

• warm_cycles — количество циклов «нагрева»,

• last_use_time — дата последнего использования, и другие параметры по вашему усмотрению.

Архитектура гибкая — вы сами определяете логику хранения и обновления профилей.

Ответ сервера

Ваш скрипт обязательно должен возвращать:

• HTTP-код 200 — при успешной обработке данных;

• Понятное текстовое сообщение, которое будет выведено в логе софта.

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

{
  "success": true,
  "message": "Профиль успешно добавлен в базу"
}