API: Поиск в социальной сети ВК (AV100 & AVinfoBot)

Основные параметры запроса:

key

Ключ доступа к API

method

Вызываемый метод

Поиск профилей в социальных сетях по номеру телефона

phone

Номер телефона

GET

https://data.av100.ru/socialapi.ashx?key=APIKEY&method=byphone&phone=XXXXXXXXX

Примеры запроса:

PHP

Python

C#

                        
// Входные данные
$url = "https://data.av100.ru/socialapi.ashx";
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "byphone",
    "phone" => "79999999999"
);

$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params);
// Преобразование ответа
$result = json_decode($response);

                        
import requests

url = "https://data.av100.ru/socialapi.ashx"

# подготовка параметров get запроса
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "phone": 79999999999,
    "method": "byphone"
}

# отправка запроса
response = requests.get(
    url=url,
    params=params
)

# преобразование ответа к словарю
data = response.json()

                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.av100.ru/socialapi.ashx";
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "phone", "79999999999" },
            { "method", "byphone" }
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = ${end_point}?{url_params}";

        HttpClient client = new();
        string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}

Результат вызова метода:

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

phone String

Номер телефона по которому запрашивается информация

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

result Object

Объект с результатом возвращаемого запроса

name String

Имя пользователя

type String

Социальная сеть (например “vk”)

id String

Идентификатор пользователя

photo String

Ссылка на фото

Результат вызова метода в случае ошибки:

Закончился доступ или запросы (Проверить доступ)

Нет необходимых прав

Некорректный ключ доступа или пользователь не создан

Номер телефона не указан

Номер телефона в недопустимом формате

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

phone String

Номер телефона по которому запрашивается информация

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

error_msg String

Сообщение с описанием ошибки

Поиск профилей в социальной сети ВК по изображению

img

Изображение в формате base64

POST - [content type = multipart/form-data]

https://data.av100.ru/socialapi.ashx?key=APIKEY&method=byphoto

Примеры запроса:

PHP

Python

C#

                        
// Входные данные
$url = "https://data.av100.ru/socialapi.ashx";
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "byphoto"
);

// Подготавливаем изображение
$filename = "image.jpg";
$img = file_get_contents($filename);
$data = base64_encode($img);

// Готовим заголовок и тело запроса
define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
define('FORM_FIELD', 'img');
$header = 'Content-Type: multipart/form-data; boundary='.MULTIPART_BOUNDARY;
$content =  "--".MULTIPART_BOUNDARY."\r\n".
"Content-Disposition: form-data; name=\"".FORM_FIELD."\"".
"\r\n\r\n".$data."\r\n"."--".MULTIPART_BOUNDARY."--\r\n";

$context = stream_context_create(array(
    'http' => array(
          'method' => 'POST',
          'header' => $header,
          'content' => $content,
    )
));
$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params, false, $context);
// Преобразование ответа
$result = json_decode($response);

                        
import requests
import base64


url = "https://data.av100.ru/socialapi.ashx"
img_path = "image.jpg"

# готовим изображение
with open(img_path, 'rb') as img_content:
    img_enc = base64.b64encode(img_content.read()).decode('utf-8')

# подготовка параметров url запроса
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method": "byphoto"
}

# отправка запроса
response = requests.post(
    url=url,
    params=params,
    files={'img': (None, img_enc)}
)

# преобразование ответа к словарю
data = response.json()

                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.av100.ru/socialapi.ashx";
        string path_img = "img.jpg";
        byte[] img_bytes = System.IO.File.ReadAllBytes(path_img);
        string base64_img = Convert.ToBase64String(img_bytes);
        HttpContent data_img = new StringContent(base64_img);

        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "method", "byphoto" }
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = ${end_point}?{url_params}";

        HttpClient client = new();
        MultipartFormDataContent form_data = new();
        form_data.Add(data_img, "img");

        string response_body = await client.PostAsync(url, form_data).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}

Результат вызова метода:

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

result Array

Массив с результатом возвращаемого запроса

Результат вызова метода в случае ошибки:

Закончился доступ или запросы (Проверить доступ)

Нет необходимых прав

Некорректный ключ доступа или пользователь не создан

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

error_msg String

Сообщение с описанием ошибки

Поиск номера телефона по профилю социальной сети ВК

В качестве параметра может быть передан идентификатор профиля или ссылка на профиль

vkid

ID профиля VK

url

URL адрес профиля VK

GET - по id профиля

https://data.av100.ru/socialapi.ashx?key=APIKEY&method=byvkprofile&vkid=XXXXX

GET - по url профиля

https://data.av100.ru/socialapi.ashx?key=APIKEY&method=byvkprofile&url=http://vk.com/idXXXXX

Примеры запроса:

PHP

Python

C#

                        
// Входные данные
$url = "https://data.av100.ru/socialapi.ashx";

// Подготовка параметров get запроса по id профиля
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "byvkprofile",
    "vkid" => 000000000
);

// Подготовка параметров get запроса по url профиля
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "byvkprofile",
    "url" => "http://vk.com/id0000000"
);

$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params);
// Преобразование ответа
$result = json_decode($response);

                        
import requests

url = "https://data.av100.ru/socialapi.ashx"

# подготовка параметров get запроса по id профиля
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method": "byvkprofile",
    "vkid": 000000000
}

# подготовка параметров get запроса по url профиля
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method": "byvkprofile",
    "url": "http://vk.com/id0000000"
}

# отправка запроса
response = requests.post(
    url=url,
    params=params,
)

# преобразование ответа к словарю
data = response.json()

                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.av100.ru/socialapi.ashx";

        // Подготовка параметров get запроса по id профиля
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "vkid", "000000" },
            { "method", "byvkprofile" }
        };

        // Подготовка параметров get запроса по url профиля
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "url", "http://vk.com/id0000000" },
            { "method", "byvkprofile" }
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = ${end_point}?{url_params}";

        HttpClient client = new();
        string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}

Результат вызова метода:

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

vkId String

Идентификатор пользователя ВК по которому запрашивается информация

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

result String

Результат возвращаемого запроса, содержащий номера телефонов разделенные запятыми

Результат вызова метода в случае ошибки:

Закончился доступ или запросы (Проверить доступ)

Нет необходимых прав

Некорректный ключ доступа или пользователь не создан

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

Описание возвращаемого JSON

start DateTime

Дата и время создание запроса

end DateTime

Дата и время окончания запроса

method String

Используемый метод обращения в запросе

vkId String

Идентификатор профиля ВК по которому запрашивается информация

error Boolean

Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия

error_msg String

Сообщение с описанием ошибки