Методы API
Список методов

Работа с задачами на получение полной информации по VIN

Добавить задачу на получение полной информации по VIN:

key
Ключ доступа к API
vin
VIN номер автомобиля

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

PHP
Python
C#
                        
// Входные данные
$url = "https://data.av100.ru/fullapi.ashx";
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "vin" => "AV1004505LK234567"
);

$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/fullapi.ashx"

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

# отправка запроса
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/fullapi.ashx";
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "vin", "AV1004505LK234567" }
        };

        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
Дата и время окончания запроса
vin String
VIN номер по которому запрашивается информация
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
result Object
Объект с результатом возвращаемой задачи
taskid Int
ID задачи по которому запрашивать результат её выполнения
credate DateTime
Дата и время создания задачи
status Int
Статус выполнения задачи. 0 - Неактивна, 1 - Начата, 2 - Выполняется, 3 - Удалена, 4 - Завершена

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

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

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

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

  • VIN написан в недопустимом формате
  • Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    vin String
    VIN номер ТС по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки

    Проверить статус готовности задачи:

    key
    Ключ доступа к API
    taskid
    Идентификатор задачи
    dates
    Ключ, активирующий отображение дат актуальности
  • Вызывать метод нужно с периодичностью от 1-5 секунд до тех пор, пока в ответном пакете не будет ссылка на подробную информацию.

  • Примеры:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.ru/fullapi.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "taskid" => 26276393,
        "dates" => 1
    );
    
    $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/fullapi.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "taskid":  26276393,
        "dates": 1
    }
    
    # отправка запроса
    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/fullapi.ashx";
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "taskid",  "26276393" },
                { "dates", "1" }
            };
    
            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
    Дата и время окончания запроса
    vin String
    VIN номер по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    result Object
    Объект с результатом возвращаемой задачи
    taskid Int
    ID задачи по которому запрашивать результат её выполнения
    credate DateTime
    Дата и время создания задачи
    finish DateTime
    Дата и время завершения задачи
    status Int
    Статус выполнения задачи. 0 - Неактивна, 1 - Начата, 2 - Выполняется, 3 - Удалена, 4 - Завершена
    mask String
    Маска ответа - набор статусов, описывающих результат каждого блока информации
    maskdates Object
    Объект с датами актуальности полей mask
    reghistory DateTime
    Дата и время завершения задачи
    dtp DateTime
    Дата и время завершения задачи
    restrict DateTime
    Дата и время завершения задачи
    eaisto DateTime
    Дата и время завершения задачи
    zalogreestr DateTime
    Дата и время завершения задачи
    osago DateTime
    Дата и время завершения задачи
    url String
    Ссылка на получение данных выполненного запроса

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

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

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    vin String
    VIN номер ТС по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки

    Описание флагов поля mask:

    0
    Не обработано
    1
    Обработано успешно
    3
    Обработано не успешно

    Назначение битов поля mask:

    1
    История регистраций
    2
    ДТП
    3
    ЕАИСТО
    4
    Ограничения
    5
    ОСАГО1 (если данных нет в этом блоке, то 6-ой бит будет всегда 3)
    6
    ОСАГО2
    7
    Реестр залогов