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

ОСАГО

Добавить задачу на получение информации об ОСАГО по VIN/госномеру:

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

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

PHP
Python
C#
                        
// Входные данные
$url = "https://data.av100.ru/autoins.ashx";

// Подготовка параметров get запроса с использованием VIN номера
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "vin" => "AV1004505LK234567"
);

// Подготовка параметров get запроса с использованием госномера
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "gosnomer" => "я100ав00"
);

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

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

# подготовка параметров get запроса с использованием госномера
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "gosnomer": "я100ав00",
}

# отправка запроса
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/autoins.ashx";

        // подготовка параметров get запроса с использованием VIN номера
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "vin", "AV1004505LK234567" }
        };

        // подготовка параметров get запроса с использованием госномера
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "gosnomer", "я100ав00" }
        };

        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 в случае её отсутствия
id Int
ID возвращаемой задачи

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

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

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

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

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

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

    key
    Ключ доступа к API
    id
    идентификатор задачи
    addinfo
    флаг, активирующий одновременное получение дополнительных данных об автомобиле и полисе
  • Вызывать метод нужно с периодичностью от 1-5 секунд до тех пор, пока в ответном пакете status не примет значение complete или error.

  • Примеры:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.ru/autoins.ashx";
    $request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "id" => 1,
        "addinfo" => 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/autoins.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "id": 1,
        "addinfo": 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/autoins.ashx";
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "id", "1" },
                { "addinfo", "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);
        }
    }
                            
                        

    Результат вызова метода (с параметром addinfo):


    Результат вызова метода (без параметра addinfo):

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

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    vin String
    VIN номер по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    id Int
    ID задачи
    status String
    Статус выполнения задачи
    result String
    Результат выполнения задачи
    dt String
    Время запроса в unix формате

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

  • Когда задача еще не готова

  • Если не указан госномер или вин

  • В очереди слишком много задач

  • Не найдены данные для VIN/госномера
  • Описание возвращаемого JSON

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