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

Работа с задачами на проверку данных ГИБДД по VIN

Добавить задачу на проверку данных ГИБДД по VIN:

key
Ключ доступа к API
vin
VIN номер автомобиля
mode
Постановка задачи (параметр mode=settask)

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

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

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

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

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

        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

datefrom DateTime
Дата и время создание запроса
dateto DateTime
Дата и время окончания запроса
vin String
VIN номер по которому запрашивается информация
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
data Object
Объект с результатом возвращаемой задачи
taskid Int
ID задачи по которому запрашивать результат её выполнения
status Int
Статус выполнения задачи

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

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

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

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

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

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

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

    key
    Ключ доступа к API
    taskid
    Идентификатор задачи
    mode
    Получение результата (параметр mode=getresult)
  • Вызывать метод нужно с периодичностью от 1-5 секунд до тех пор, пока в ответном пакете не будет даты в поле taskend.

  • Примеры:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.tronk.info/gai.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "taskid" => "dcaf0957-9f4b-452d-b2ba-a689e92fc284",
        "mode" => "getresult"
    );
    
    $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/gai.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "taskid":  "dcaf0957-9f4b-452d-b2ba-a689e92fc284",
        "mode": "getresult"
    }
    
    # отправка запроса
    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/gai.ashx";
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "taskid",  "dcaf0957-9f4b-452d-b2ba-a689e92fc284" },
                { "mode", "getresult" }
            };
    
            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

    datefrom DateTime
    Дата и время создание запроса
    dateto DateTime
    Дата и время окончания запроса
    vin String
    VIN номер по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    data Object
    Объект с результатом возвращаемой задачи
    taskid Int
    ID задачи по которому запрашивать результат её выполнения
    taskstart DateTime
    Дата и время создания задачи
    taskend DateTime
    Дата и время завершения задачи
    status Int
    Статус выполнения задачи

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

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

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