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

Справочники

key
Ключ доступа к API
methodname
(обязательно, если не указан name) Название метода по которому требуется получить справочники
Доступные методы: vehicleinsdata / offer / priceapi / fsspdata
name
(обязательно, если не указан methodname) Название справочника
Доступные справочники: marksandmodels / fsspregion / priceregion / offerssource / offersregion
Если указаны оба параметра methodname и name, ответ на запрос будет на основе параметра methodname


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

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

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

# входные данные
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "methodname": "offer",
    # или
    "name": "marksandmodels"
}

# отправка запроса
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/dictionaries.ashx";
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "methodname", "offer" },
            // или
            { "тфьу", "marksandmodels" }
        };

        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
Дата и время окончания запроса
name String
Название запрашиваемого справочника
methodname String
Название метода по которому запрашиваются справочники
withMethod Boolean
Признак ответа на основе названия метода
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
result Object
Объект с результатом возвращаемого запроса
Regions Object
Многомерный Объект со списком регионов
Sources Object
Многомерный Объект со списком источников
BrandsModels Object
Многомерный Объект с многомерным списком Марок ТС и Моделей

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

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

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

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

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

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    name String
    Название запрашиваемого справочника
    methodname String
    Название метода по которому запрашиваются справочники
    withMethod Boolean
    Признак ответа на основе названия метода
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки