Методы API
Полный автомобильный отчёт
Предварительная проверка автомобиля
Получение информации об автомобиле
Определение стоимости автомобиля
Конвертация и распознавание данных
Лента объявлений
Проверка физических и юридических лиц
Служебные методы
Список методов

Получение отчёта по VIN

Метод работает через создание задачи и последующий опрос статуса. Сначала необходимо создать задачу с параметром mode=task, получить task_id, затем периодически запрашивать статус этой задачи до получения статуса completed или failed.

Создать задачу на получение отчёта по VIN:

key
API-ключ
vin
VIN автомобиля
mode
Режим создания задачи. Необходимо передать значение task

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

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

$get_params = http_build_query($request_params);

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

url = "https://data.tronk.info/zalogvin.ashx"

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

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

        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

requestTime DateTime
Время выполнения запроса
start DateTime
Дата и время начала обработки запроса
end DateTime
Дата и время окончания обработки запроса
vin String
VIN автомобиля
frame String
Номер кузова, если он использовался или был определён
error Boolean
Признак ошибки
task_id String
Идентификатор задачи. Его необходимо передавать при проверке статуса
status String
Текущий статус обработки задачи
requestDate DateTime
Дата создания запроса
result Array
Результат проверки. При создании задачи обычно возвращается пустой массив

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

key
API-ключ
vin
VIN автомобиля
mode
Режим работы. Необходимо передать значение task
task_id
Идентификатор задачи, полученный при создании задачи
  • После получения task_id необходимо периодически выполнять запрос проверки статуса задачи.
  • Пока статус равен pending или in_progress, нужно продолжать опрос через заданный интервал.
  • При статусе completed результат готов. При статусе failed обработка завершилась ошибкой.

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

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.tronk.info/zalogvin.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "vin" => "X9FLXXEEBLCG05025",
        "mode" => "task",
        "task_id" => "03c89bd5-cde7-4a62-b5a3-d42c701e7d70"
    );
    
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    
    url = "https://data.tronk.info/zalogvin.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "vin": "X9FLXXEEBLCG05025",
        "mode": "task",
        "task_id": "03c89bd5-cde7-4a62-b5a3-d42c701e7d70"
    }
    
    # отправка запроса
    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.tronk.info/zalogvin.ashx";
            Dictionary<string, string> dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "vin", "X9FLXXEEBLCG05025" },
                { "mode", "task" },
                { "task_id", "03c89bd5-cde7-4a62-b5a3-d42c701e7d70" }
            };
    
            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

    requestTime DateTime
    Время выполнения запроса
    start DateTime
    Дата и время начала обработки запроса
    end DateTime
    Дата и время окончания обработки запроса
    vin String
    VIN автомобиля
    frame String
    Номер кузова, если он использовался или был определён
    error Boolean
    Признак ошибки
    task_id String
    Идентификатор задачи
    status String
    Текущий статус обработки задачи
    requestDate DateTime
    Дата создания запроса
    result Array
    Массив найденных записей по залогу
    Date DateTime
    Дата возникновения залога
    Number String
    Номер уведомления
    Vin String
    VIN автомобиля
    Pledgor String
    Залогодатель
    Pledgee String
    Залогодержатель
    PledgorType String
    Тип залогодателя
    PledgeeType String
    Тип залогодержателя
    PledgorINN String
    ИНН залогодателя
    PledgeeINN String
    ИНН залогодержателя
    PledgorOgrn String
    ОГРН залогодателя
    PledgeeOgrn String
    ОГРН залогодержателя
    StopDate DateTime
    Дата прекращения залога
    StopNumber String
    Номер уведомления о прекращении залога
    FileName String
    Название файла документа
    FileLink String
    Ссылка на файл документа

    Статусы задачи:

    pending
    Задача создана и ожидает начала обработки
    in_progress
    Задача находится в обработке
    completed
    Обработка успешно завершена, результат готов
    failed
    Обработка завершилась ошибкой

    Рекомендуемый сценарий работы:

    1. Отправить запрос на создание задачи с параметром mode=task.
    2. Получить из ответа task_id.
    3. Периодически выполнять запрос проверки статуса с передачей task_id.
    4. Дождаться статуса completed или failed.
    5. Пока статус равен pending или in_progress, продолжать опрос статуса через заданный интервал.

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

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

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

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

  • Сервис временно недоступен

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

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