authorization

Функция авторизации в сервисе.

Структура входных данных в формате JSON

{
	"method": "authorization",
	"login": (string),
	"password": (string),
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
login Имя пользователя, допускается использование только латинских букв. Минимальная длина 4 символа, максимальная 12. да
password Пароль пользователя, минимальная длинна 5 символов. да
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	response: "uapikey": (string)
}

Ниже приведено описание параметров.

Параметр Описание
uapikey Секретный API-ключ авторизованного пользователя.

Пример реализации

$param = array(
	'method' => 'authorization',
	'login' => 'test',
	'password' => '1234',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

registration

Функция регистрации нового пользователя.

Структура входных данных в формате JSON

{
	"method": "registration",
	"name": (string),
	"login": (string),
	"email": (string),
	"password": (string),
	"mobile": (int),
	"captcha": (string),
	“secret_key”: (string)
}

Описание параметров

Параметр Описание Обязательный
name Имя регистрируемоего человека, ФИО. да
login Имя пользователя, допускается использование только латинских букв. Минимальная длина 4 символа, максимальная 12. да
email Адрес электронной почты, регистрируемого человека, стандартный формат. да
password Пароль пользователя, минимальная длинна 5 символов. да
mobile Номер телефона в открытом формате, 11 символов. да
captcha Распознанная строка, для подтверждения действий. Распознается по предварительно полученному изображению методом captcha. да
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"response": (bool) 
}

Ниже приведено описание параметров.

Возвращает статус запроса - успешен или нет в логическом формате: true или false.

Пример реализации

$param = array(
	'method' => 'registration',
	'name': 'Пупкин Василий Иванович',
	'login': 'pupkin',
	'email': 'pupkin.v.i@gmail.com',
	'password': 'Frk32mfspD',
	'mobile': '89123456789',
	'captcha': 'n3fa8',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

captcha

Метод получения изображения для распознания кода подтверждения действий. Используется для организации регистрации нового пользователя в сервисе методом registration.

Структура входных данных в формате JSON

{
	"method": "captcha",
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"response": (data:image/jpeg;base64)
}

Ниже приведено описание параметров.

Возвращает данные в формате Data URI, изображение для подтверждения ввведения данных

Пример реализации

$param = array(
	'method' => 'captcha',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

passwordRecovery

Запрос на восстановление пароля.

Структура входных данных в формате JSON

{
	"method": "passwordRecovery",
	"user": (string),
	"email": (string),
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
user Имя пользователя, для которого запрашивается восстановление пароля. да
email Адрес электронной почты зарегистрированного человека, стандартный формат. да
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"response": {
		"password": (string)
	}
}

Ниже приведено описание параметров.

Параметр Описание
password Строка, содержащая пароль.

Пример реализации

$param = array(
	'method' => 'passwordRecovery',
	'user' => 'pupkin',
	'email' => 'pupkin.v.i@gmail.com',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

newSiteTrack

Создание нового трекера для идентификации.

Структура входных данных в формате JSON

{
	"method": "newSiteTrack",
	"domain": (string),
	"track_name": (string),
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
domain Домен, для которого будет генерироваться скрипт идентификации и создаваться трекер. да
track_name Наименование трекера. да
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"response": {
		"code":(string),
		"trackid":(string)
	}
}

Ниже приведено описание параметров.

Параметр Описание
code Строка, содержащая код скрипта для веб-страницы.
trackid Идентификатор созданного трекера.

Пример реализации

$param = array(
	'method' => 'newSiteTrack',
	"domain": 'http://mysite.ru',
	"track_name": 'Мой сайт',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

balance

Запрос текущего баланса в сервисе.

Структура входных данных в формате JSON

{
	"method": "balance",
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"response":(int)
}

Ниже приведено описание параметров.

Возвращает число, остаток денег на лицевом счете в сервисе.

Пример реализации

$param = array(
	'method' => 'balance',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

getCost

Возвращает текущую стоимость одной идентификации, установленную партнером.

Структура входных данных в формате JSON

{
	"method": "getCost",
	"secret_key": (string)
}

Описание параметров

Параметр Описание Обязательный
secret_key Партнерский секретный ключ API. Выдается при регистрации панели. да

Результирующие параметры в формате JSON

{
	"cost":(int)
}

Ниже приведено описание параметров.

Параметр Описание
cost Возвращает числовое значение цены, если не задана, возвращает цену идентификации, заданную сервисом.

Пример реализации

$param = array(
	'method' => 'getCost',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

getUser

Возвращает список пользователей из собранной базы данных. Через эту функцию осуществляется экспорт базы данных в сторонние системы.

Структура входных данных в формате JSON

{
	"method": "getUser",
	"user": (string),
	"secret_key": (string),
	"tracker": (string),
	"sort": (int),
	"count": (int),
	"offset": (int),
	"tf": (int),
	"tt": (int),
	"field": (string)
}

Описание параметров

Параметр Описание Обязательный
tracker Идентификатор трекера идентификации. По умолчанию, выборка осуществляется из общей базы. нет
sort Флаг сортировки выгружаемой базы по времени идентификации:
  • 0 - по возрастанию;
  • 1 - по убыванию.
По умолчанию, значение 1.
нет
count Количество возвращаемых записей из базы. По умолчанию, максимальное значение - 1000. нет
offset Смещение относительно начала списка в базе для выборки определенного подмножества записей. По умолчанию, значение 0. нет
tf Временная метка начала выборки записей в формате unixtime. нет
tt Временная метка окончание выборки записей в формате unixtime. нет
field Список полей, которые необходимо выгрузить. Может включать следующие значения, перечисленные через ",":
  • id - идентификатор пользователя ВКонтакте;
  • first_name - имя пользователя;
  • last_name - фамилия пользователя;
  • bdate - дата рождения;
  • city - город, указанный в профиле Вконтакте;
  • country - страна, указанная в профиле Вконтакте;
  • relation - семейное положение, указанное в профиле Вконтакте;
  • status - статус, указанный в профиле Вконтакте;
  • sex - пол, указанный в профиле Вконтакте;
  • mobile_phone - номер телефона, указанный в профиле Вконтакте;
  • photo_50 - аватар Вконтакте размером 50х50;
  • photo_max_orig - аватар Вконтакте в исходных размерах;
  • skype - логин пользователя в skype, указанный в профиле Вконтакте;
  • twitter - логин пользователя в twitter, указанный в профиле Вконтакте;
  • livejournal - логин пользователя в livejournal, указанный в профиле Вконтакте;
  • facebook - идентификатор пользователя на facebook, указанный в профиле Вконтакте;
  • facebook_name - имя пользователя на facebook;
  • instagram - логин пользователя в instagram, указанный в профиле Вконтакте;
  • movies - любимые фильмы, указанные в профиле Вконтакте;
  • games - любимые игры, указанные в профиле Вконтакте;
  • about - информация "о себе", указанные в профиле Вконтакте;
  • tv - любимые телепередачи, указанные в профиле Вконтакте;
  • books - любимые книги, указанные в профиле Вконтакте;
  • universities - университет(ы), указанные в профиле Вконтакте;
  • schools - школа(ы), указанные в профиле Вконтакте;
  • name - наименование трекера, по-которому отследился пользователь;
  • unic - уникальный идентификатор пользователя;
  • yakey - интересы пользователя по данным Яндекса;
  • domain - домен, на котором произошла идентификация пользователя;
  • url - страница на которой произошла идентификация;
  • time - время идентификации пользователя;
  • geo - местонахождение пользователя в момент идентификации;
  • refer_info - источник перехода пользователя;
  • ip - сетевой адрес, с которого зашел посетитель.
По умолчанию, указано только поле id.
нет

Результирующие параметры в формате JSON

{
	"response": [
		/* DataInfoUser */
		"users": { 
			/* UserObj */
			"id": (int),
			"first_name": (string),
			"last_name": (string),
			"bdate": (string),
			"city": (string),
			"country": (string),
			"relation": (string),
			"status": (string),
			"sex": (string),
			"mobile_phone": (string),
			"photo_50": (string),
			"photo_max_orig": (string),
			"skype": (string),
			"twitter": (string),
			"livejournal": (string),
			"facebook": (string),
			"facebook_name": (string),
			"instagram": (string),
			"movies": (string),
			"games": (string),
			"about": (string),
			"tv": (string),
			"books": (string),
			"universities": [
				{
					"id": (int),
					"country": (string),
					"city": (string),
					"name": (string),
					"faculty_name": (string),
					"chair_name": (string),
					"graduation": (int),
					"education_form": (string),
					"education_status": (string),
				},
				...
			],
			"schools": [
				{
					"id": (string),
					"country": (string),
					"city": (string),
					"name": (string),
					"year_from": (int),
					"year_to": (int),
					"year_graduated": (int),
					"class": (string),
					"speciality": (string),
					"type_str": (string)
				},
				...
			],
			"name": (string),
			"unic": (string),
			"yakey": (string),
			"domain": (string),
			"url": [
				"host": (string),
				"link": (string)
			],
			"time":  (int),
			"geo": [
				"city": (string),
				"region": (string),
				"lat": (string),
				"lng": (string),
				"district": (string)
			],
			"refer_info": [
				"type" (int),
				"host" (string),
				"query" (string),
				"link" (string),
				"name" (string)
			],
			"ip": (string)
		}
		...
	]
}

Ниже приведено описание параметров.

Параметр Описание
id Идентификатор пользователя ВКонтакте.
first_name Имя пользователя.
last_name Фамилия пользователя.
bdate Дата рождения пользователя.
city Город, указанный в профиле Вконтакте.
country Страна, указанная в профиле Вконтакте.
relation Семейное положение, указанное в профиле Вконтакте.
status Статус, указанный в профиле Вконтакте.
sex Пол, указанный в профиле Вконтакте.
mobile_phone Номер телефона, указанный в профиле Вконтакте.
photo_50 Аватар Вконтакте размером 50х50.
photo_max_orig Аватар Вконтакте в исходных размерах.
skype Логин пользователя в skype, указанный в профиле Вконтакте.
twitter Логин пользователя в twitter, указанный в профиле Вконтакте.
livejournal Логин пользователя в livejournal, указанный в профиле Вконтакте.
facebook Идентификатор пользователя на facebook, указанный в профиле Вконтакте.
facebook_name Имя пользователя на facebook
instagram Логин пользователя в instagram, указанный в профиле Вконтакте.
movies Любимые фильмы, указанные в профиле Вконтакте.
games Любимые игры, указанные в профиле Вконтакте.
about Информация "о себе", указанные в профиле Вконтакте.
tv Любимые телепередачи, указанные в профиле Вконтакте.
books Любимые книги, указанные в профиле Вконтакте.
universities Университет(ы), указанные в профиле Вконтакте:
  • id - идентификатор университета, указанные в профиле Вконтакте.;
  • country - страна университета;
  • city - город университета;
  • name - наименование университета;
  • faculty_name - наименование факультета;
  • chair_name - наименование кафедры факультета;
  • graduation - год окончания учебы;
  • education_form - форма обучения.
schools Школа(ы), указанные в профиле Вконтакте:
  • id - идентификатор школы, указанные в профиле Вконтакте.;
  • country - страна школы;
  • city - город школы;
  • name - наименование школы;
  • year_from - год начала обучения;
  • year_to - год окончания обучения;
  • year_graduated - год выпуска;
  • class - тип класса;
  • speciality - специализация;
  • type_str - тип учебного заведения.
name Наименование трекера, по-которому отследился пользователь.
unic Уникальный идентификатор пользователя.
yakey Интересы пользователя по данным Яндекса.
domain Домен, на котором произошла идентификация пользователя.
time Время идентификации пользователя.
url Страница на которой произошла идентификация.
  • host - домен на которой произошла идентификация.
  • link - ссылка на страницу на которой произошла идентификация.
geo Местоположение пользователя в момент идентификации.
  • city - город.
  • region - регион.
  • lat - географические координаты широты
  • lng - географические координаты долготы
  • district - федеральный округ
refer_info Источник перехода пользователя.
  • type - тип источника
    • 0 - прямой заход
    • 1 - сайт
    • 2 - социальная сеть
    • 3 - поисковая система
  • host - домен перехода
  • query - поисковый запрос (если переход был из поиска)
  • link - ссылка на страницу с которой был переход
  • name - название поисковой системы (если переход был из поиска)

Пример реализации

$param = array(
	'method' => 'getUser',
	'user' => 'test',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540',
	'count' => 150,
	'offset' => 40,
	'tf' => 1404803272,
	'field' => 'first_name,last_name,sex,yakey,ip,unic'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

getUserIp

Возвращает пользователя из базы идентифицированных профилей по IP-адресу.

Структура входных данных в формате JSON

{
	"method": "getUserIp",
	"user": (string),
	"secret_key": (string),
	"ip": (string),
	"field": (string)
}

Описание параметров

Парамерт Описание Обязательный
ip IP-адрес, по которому нужно идентифицировать пользователя в базе идентифицированных профилей. да
field Список полей, которые необходимо выгрузить. Может включать следующие значения, перечисленные через ",":
  • id - идентификатор пользователя ВКонтакте;
  • first_name - имя пользователя;
  • last_name - фамилия пользователя;
  • bdate - дата рождения;
  • city - город, указанный в профиле Вконтакте;
  • country - страна, указанная в профиле Вконтакте;
  • relation - семейное положение, указанное в профиле Вконтакте;
  • status - статус, указанный в профиле Вконтакте;
  • sex - пол, указанный в профиле Вконтакте;
  • mobile_phone - номер телефона, указанный в профиле Вконтакте;
  • photo_50 - аватар Вконтакте размером 50х50;
  • photo_max_orig - аватар Вконтакте в исходных размерах;
  • skype - логин пользователя в skype, указанный в профиле Вконтакте;
  • twitter - логин пользователя в twitter, указанный в профиле Вконтакте;
  • livejournal - логин пользователя в livejournal, указанный в профиле Вконтакте;
  • facebook - идентификатор пользователя на facebook, указанный в профиле Вконтакте;
  • facebook_name - имя пользователя на facebook;
  • instagram - логин пользователя в instagram, указанный в профиле Вконтакте;
  • movies - любимые фильмы, указанные в профиле Вконтакте;
  • games - любимые игры, указанные в профиле Вконтакте;
  • about - информация "о себе", указанные в профиле Вконтакте;
  • tv - любимые телепередачи, указанные в профиле Вконтакте;
  • books - любимые книги, указанные в профиле Вконтакте;
  • universities - университет(ы), указанные в профиле Вконтакте;
  • schools - школа(ы), указанные в профиле Вконтакте;
  • name - наименование трекера, по-которому отследился пользователь;
  • unic - уникальный идентификатор пользователя;
  • yakey - интересы пользователя по данным Яндекса;
  • domain - домен, на котором произошла идентификация пользователя;
  • url - страница на которой произошла идентификация;
  • time - время идентификации пользователя;
  • geo - местонахождение пользователя в момент идентификации;
  • refer_info - источник перехода пользователя;
  • ip - сетевой адрес, с которого зашел посетитель.
По умолчанию, указано только поле id.
нет

Результирующие параметры в формате JSON

{
	"response": {
		/* DataInfoUser */
		"users": { 
			/* UserObj */
			"id": (int),
			"first_name": (string),
			"last_name": (string),
			"bdate": (string),
			"city": (string),
			"country": (string),
			"relation": (string),
			"status": (string),
			"sex": (string),
			"mobile_phone": (string),
			"photo_50": (string),
			"photo_max_orig": (string),
			"skype": (string),
			"twitter": (string),
			"livejournal": (string),
			"facebook": (string),
			"facebook_name": (string),
			"instagram": (string),
			"movies": (string),
			"games": (string),
			"about": (string),
			"tv": (string),
			"books": (string),
			"universities": [
				{
					"id": (int),
					"country": (string),
					"city": (string),
					"name": (string),
					"faculty_name": (string),
					"chair_name": (string),
					"graduation": (int),
					"education_form": (string),
					"education_status": (string),
				},
				...
			],
			"schools": [
				{
					"id": (string),
					"country": (string),
					"city": (string),
					"name": (string),
					"year_from": (int),
					"year_to": (int),
					"year_graduated": (int),
					"class": (string),
					"speciality": (string),
					"type_str": (string)
				},
				...
			],
			"name": (string),
			"unic": (string),
			"yakey": (string),
			"domain": (string),
			"url": [
				"host": (string),
				"link": (string)
			],
			"time":  (int),
			"geo": [
				"city": (string),
				"region": (string),
				"lat": (string),
				"lng": (string),
				"district": (string)
			],
			"refer_info": [
				"type" (int),
				"host" (string),
				"query" (string),
				"link" (string),
				"name" (string)
			],
			"ip": (string)
		}
	}
}

Ниже приведено описание параметров.

Параметр Описание
id Идентификатор пользователя ВКонтакте.
first_name Имя пользователя.
last_name Фамилия пользователя.
bdate Дата рождения пользователя.
city Город, указанный в профиле Вконтакте.
country Страна, указанная в профиле Вконтакте.
relation Семейное положение, указанное в профиле Вконтакте.
status Статус, указанный в профиле Вконтакте.
sex Пол, указанный в профиле Вконтакте.
mobile_phone Номер телефона, указанный в профиле Вконтакте.
photo_50 Аватар Вконтакте размером 50х50.
photo_max_orig Аватар Вконтакте в исходных размерах.
skype Логин пользователя в skype, указанный в профиле Вконтакте.
twitter Логин пользователя в twitter, указанный в профиле Вконтакте.
livejournal Логин пользователя в livejournal, указанный в профиле Вконтакте.
facebook Идентификатор пользователя на facebook, указанный в профиле Вконтакте.
facebook_name Имя пользователя на facebook
instagram Логин пользователя в instagram, указанный в профиле Вконтакте.
movies Любимые фильмы, указанные в профиле Вконтакте.
games Любимые игры, указанные в профиле Вконтакте.
about Информация "о себе", указанные в профиле Вконтакте.
tv Любимые телепередачи, указанные в профиле Вконтакте.
books Любимые книги, указанные в профиле Вконтакте.
universities Университет(ы), указанные в профиле Вконтакте:
  • id - идентификатор университета, указанные в профиле Вконтакте.;
  • country - страна университета;
  • city - город университета;
  • name - наименование университета;
  • faculty_name - наименование факультета;
  • chair_name - наименование кафедры факультета;
  • graduation - год окончания учебы;
  • education_form - форма обучения.
schools Школа(ы), указанные в профиле Вконтакте:
  • id - идентификатор школы, указанные в профиле Вконтакте.;
  • country - страна школы;
  • city - город школы;
  • name - наименование школы;
  • year_from - год начала обучения;
  • year_to - год окончания обучения;
  • year_graduated - год выпуска;
  • class - тип класса;
  • speciality - специализация;
  • type_str - тип учебного заведения.
name Наименование трекера, по-которому отследился пользователь.
unic Уникальный идентификатор пользователя.
yakey Интересы пользователя по данным Яндекса.
domain Домен, на котором произошла идентификация пользователя.
time Время идентификации пользователя.
url Страница на которой произошла идентификация.
  • host - домен на которой произошла идентификация.
  • link - ссылка на страницу на которой произошла идентификация.
geo Местоположение пользователя в момент идентификации.
  • city - город.
  • region - регион.
  • lat - географические координаты широты
  • lng - географические координаты долготы
  • district - федеральный округ
refer_info Источник перехода пользователя.
  • type - тип источника
    • 0 - прямой заход
    • 1 - сайт
    • 2 - социальная сеть
    • 3 - поисковая система
  • host - домен перехода
  • query - поисковый запрос (если переход был из поиска)
  • link - ссылка на страницу с которой был переход
  • name - название поисковой системы (если переход был из поиска)

Пример реализации

$param = array(
	'method' => 'getUserIp',
	'user' => 'test',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540',
	'ip' => '192.168.0.1',
	'field' => 'first_name,last_name,sex,yakey,ip,unic'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

delUser

Удаляет пользователя из базы по уникальному идентификатору.

Структура входных данных в формате JSON

{
	"method": "delUser",
	"user": (string),
	"secret_key": (string),
	"unic": (string)
}

Описание параметров

Парамерт Описание Обязательный
unic Уникальный идентификатор пользователя. да

Результирующие параметры в формате JSON

{
	"response": (bool)
}

Пример реализации

$param = array(
	'method' => 'delUser',
	'user' => 'test',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540',
	'unic' => 'c5792b5d4f7feee53a0484f510093544'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

getTrackers

Возвращает список треккеров аккаунта.

Структура входных данных в формате JSON

{
	"method": "getTrackers",
	"user": (string),
	"secret_key": (string)
}

Описание параметров

Парамерт Описание Обязательный
unic Уникальный идентификатор пользователя. да

Результирующие параметры в формате JSON

{
	"response": {
		"tracker": [
			{
			"name": (string),
			"trackid": (int),
			"createdate": (string),
			"type": (string)	
			}
		…
		]	
	}
}

Ниже приведено описание параметров.

Параметр Описание
name Идентификатор трекера.
trackid Имя пользователя.
createdate Дата создание трекера.
type Тип трекера:
  • site - трекер для сайта;
  • link - идентификационная ссылка.

Пример реализации

$param = array(
	'method' => 'getTrackers',
	'user' => 'test',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

statistic

Возвращает статистику по данным в базе.

Структура входных данных в формате JSON

{
	"method": "statistic",
	"user": (string),
	"secret_key": (string),
	"param": (string),
	"tracker": (string)
}

Описание параметров

Парамерт Описание Обязательный
param Список полей, которые необходимо выгрузить. Может включать следующие значения, указанные через ",":
  • daytrackstat - массив количества отследившихся по дням текущего месяца;
  • alldaytrackstat - массив количества отследившихся за все время;
  • latestusers - массив ТОП-10 последних отследившихся;
  • rlistcity - ТОП-7 городов из которых больше всего идентификаций;
  • rlistvkcity - ТОП-7 городов из которых больше всего идентификаций относительно указанного города на странице ВК;
  • listvkcity - польный список городов откуда отследились пользователи;
  • 100key - ТОП-100 запросов по которым люди заходи на сайт и отследились;
  • allkey - список ключевых запросов;
  • interestlist - список яндекс интересов пользователей;
  • interestusers - список яндекс интересов по пользователям.
да
tracker Идентификатор трекера идентификации, по которому необходимо выгрузить статистику. нет

Результирующие параметры в формате JSON

{
	"statistics": {
		"daytrackstat": [
			{
				"1": (int),
				"2": (int),
				"3": (int),
				"4": (int)
			},
			...
		],
		"alldaytrackstat": {
			"1": (int),
			"2": (int),
			"3": (int),
			"4": (int)
		},
		"latestusers": [
			{
				"0": (string),
				"1": (string),
				"2": (string),
				"3": (string),
				"4": (string)
			},
			...
		],
		"rlistcity": {
			(key): (int),
			...
		},
		"rlistvkcity": {
			(key): (int),
			...
		},
		"listvkcity": [
			{
				(key): (int),
				...
			},
			...
		],
		"100key": {
			(string): (int),
			...
		},
		"allkey": [
			{
				"0": (string),
				"1": (string),
				"2": (string),
				"3": (string),
				"4": (string),
			},
			...
		],
		"interestlist": [
			{
				(key): (int),
				...
			},
			...
		],
		"interestusers": {
			{
				(key): (int),
				...
			},
			...
		}
	}
}

Ниже приведено описание параметров.

Параметр Описание
daytrackstat Массив количества отследившихся по дням текущего месяца относительно источника трафика.
  • 1 - переходы с сайтов;
  • 2 - переходы из Вконтакте;
  • 3 - прямые заходы;
  • 4 - преходы из поиска.
alldaytrackstat Массив количества отследившихся за все время относительно источника трафика.
  • 1 - переходы с сайтов;
  • 2 - переходы из Вконтакте;
  • 3 - прямые заходы;
  • 4 - преходы из поиска.
latestusers Массив ТОП-10 последних отследившихся.
  • 0 - наименование трекера;
  • 1 - сслыка на авватар пользователя;
  • 2 - Имя и фалимия пользователя;
  • 3 - идентификатор пользователя во Вконтакте;
  • 4 - Дата и время идентификации.
rlistcity ТОП-7 городов из которых больше всего идентификаций.
  • Город - количество.
rlistvkcity ТОП-7 городов из которых больше всего идентификаций относительно указанного города на странице Вконтакте.
  • Город - количество.
listvkcity Польный список городов откуда отследились пользователи.
  • Город - количество.
100key ТОП-100 запросов по которым люди заходи на сайт и отследились.
  • Запрос - количество.
allkey Список ключевых запросов.
  • 0 - ключевой запрос;
  • 1 - источник перехода;
  • 2 - url запроса;
  • 3 - наименование трекера идентификации;
  • 4 - дата и время идентификации.
interestlist Список яндекс интересов пользователей.
  • Интерес - количество.
interestusers список яндекс интересов по пользователям.
  • Пользователь - интерес.

Пример реализации

$param = array(
	'method' => 'statistic',
	'user' => 'test',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540', 
	'param' => 'interestusers,rlistvkcity,100key,interestlist'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);

userExport

Экспортирование базы.

Структура входных данных в формате JSON

{
	"method": "userExport",
	"type": (int),
	"request": (string),
	"secret_key": (string)
}

Описание параметров

Парамерт Описание Обязательный
type Тип выгрузки:
  • 1 - база идентификаций;
да
request Тип запроса.
  • send - отправка запроса на формирование выгрузки;
  • link - получение ссылки на загрузку экспортированной базы;
да

Результирующие параметры в формате JSON

Резулитат удачного запроса при request=send
{
	"response": (bool)
}
Результат выполнения при request=link
{
	"response": { 
		"link": (string)
	}
}

Ниже приведено описание параметров.

Параметр Описание
link Ссылка на загрузку экспортированной базы

Пример реализации

$param = array(
	'method' => 'userExport',
	'type' => 1,
	'request' => 'send',
	'secret_key' => '7a2486bd5fb290c638b7469330ca8540'
);
$json = json_encode($param);

$ch = curl_init("http://socdb.ru");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, array("json" => $json));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);