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

Поиск VIN по госномеру (конвертация)

Метод convertation выполняет поиск VIN и сведений о транспортном средстве по госномеру. Источник — TRONK, стоимость — 6 руб. / запрос.

1. Передайте госномер с mode=settask и сохраните taskId из ответа.
2. Запрашивайте mode=getresult, передавая идентификатор в параметре taskid, пока state = processing.
3. При state = complete прочитайте data, при state = error — сообщение в message и прекратите ожидание.
Для ожидания результата используйте getresult: повторный settask создает отдельную задачу.
Методы convertb2b и vinbynumber перенесены в архив и более недоступны. Актуальный метод конвертации — convertation.ashx.

Постановка задачи:

key
API-ключ пользователя с доступом к методу convertation. Обязательный параметр.
gosnumber
Государственный регистрационный номер ТС. Обязательный параметр; пример: у678ра174.
mode
Режим settask. Обязательный параметр.

Передавайте кириллицу в UTF-8 с URL-кодированием. Примеры ниже кодируют параметры автоматически. Если gosnumber отсутствует, обработчик также принимает number, затем gosnomer; в новых интеграциях используйте gosnumber.

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

PHP
Python
C#
$url = "https://data.tronk.info/convertation.ashx";
$params = array(
    "key" => "USER_API_KEY",
    "mode" => "settask",
    "gosnumber" => "у678ра174"
);
$response = file_get_contents($url . "?" . http_build_query($params));
$result = json_decode($response, true);
import requests

params = {
    "key": "USER_API_KEY",
    "mode": "settask",
    "gosnumber": "у678ра174"
}
response = requests.get("https://data.tronk.info/convertation.ashx", params=params, timeout=30)
response.raise_for_status()
result = response.json()
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main()
    {
        var parameters = new Dictionary<string, string>
        {
            { "key", "USER_API_KEY" },
            { "mode", "settask" },
            { "gosnumber", "у678ра174" }
        };
        var query = string.Join("&", parameters.Select(p =>
            Uri.EscapeDataString(p.Key) + "=" + Uri.EscapeDataString(p.Value)));
        using (var client = new HttpClient())
        {
            var response = await client.GetStringAsync("https://data.tronk.info/convertation.ashx?" + query);
            var result = JsonConvert.DeserializeObject(response);
        }
    }
}

Задача создана

Поля ответа на постановку задачи

start
дата и время начала обработки API-запроса.
end
дата и время окончания обработки API-запроса.
gosnumber
государственный регистрационный номер ТС, по которому поставлена задача.
error
признак ошибки. false — запрос выполнен без ошибки, true — при выполнении запроса произошла ошибка.
error_code
код ошибки. 0 — ошибка отсутствует.
error_msg
текст ошибки. Пустое значение — ошибка отсутствует.
taskId
уникальный идентификатор созданной задачи. Используется для последующего получения результата.

Имя поля в ответе на постановку — taskId (с заглавной I); параметр получения и поле ответа с результатом — taskid.


Получение результата:

key
API-ключ пользователя, создавшего задачу. Обязательный параметр.
mode
Режим getresult. Обязательный параметр.
taskid
GUID задачи из поля taskId ответа settask. Обязательный параметр.

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

PHP
Python
C#
$url = "https://data.tronk.info/convertation.ashx";
$params = array(
    "key" => "USER_API_KEY",
    "mode" => "getresult",
    "taskid" => "a5ad77d1-e1ce-4bcc-95f5-6a22bbabb753"
);
$response = file_get_contents($url . "?" . http_build_query($params));
$result = json_decode($response, true);
import requests

params = {
    "key": "USER_API_KEY",
    "mode": "getresult",
    "taskid": "a5ad77d1-e1ce-4bcc-95f5-6a22bbabb753"
}
response = requests.get("https://data.tronk.info/convertation.ashx", params=params, timeout=30)
response.raise_for_status()
result = response.json()
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main()
    {
        var parameters = new Dictionary<string, string>
        {
            { "key", "USER_API_KEY" },
            { "mode", "getresult" },
            { "taskid", "a5ad77d1-e1ce-4bcc-95f5-6a22bbabb753" }
        };
        var query = string.Join("&", parameters.Select(p =>
            Uri.EscapeDataString(p.Key) + "=" + Uri.EscapeDataString(p.Value)));
        using (var client = new HttpClient())
        {
            var response = await client.GetStringAsync("https://data.tronk.info/convertation.ashx?" + query);
            var result = JsonConvert.DeserializeObject(response);
        }
    }
}

Задача ожидает обработки

Во время обработки state также равен processing, а message содержит «запрос обрабатывается».

Задача завершена

Поля результата:

Корневые даты имеют формат ДД.ММ.ГГГГ ЧЧ:мм:сс. Даты регистрационного документа в data возвращаются в формате источника, например 2020-08-11T00:00:00. Отдельные поля data могут быть null или отсутствовать; не все источники возвращают все сведения.

start
дата и время начала обработки текущего API-запроса.
end
дата и время окончания обработки текущего API-запроса.
gosnumber
государственный регистрационный номер ТС, по которому выполнен запрос.
error
Признак ошибки текущего API-запроса. Ошибку обработки задачи определяйте по state = error: в этом случае поле error текущей версии метода остается false.
message
текст сообщения или ошибки. null — дополнительное сообщение отсутствует.
data
Результат источника. Пока задача обрабатывается или завершена с ошибкой — null. Даже при state = complete может быть null, если источник не вернул данные или его ответ не удалось прочитать.
data.requestId
уникальный идентификатор запроса к источнику данных.
data.licenseNumber
государственный регистрационный номер ТС, по которому источник выполнял поиск.
data.vinCode
VIN, уникальный идентификационный номер транспортного средства.
data.processingState
статус обработки запроса источником. done — обработка завершена.
data.registrationCertSeries
серия свидетельства о регистрации транспортного средства (СТС).
data.registrationCertNumber
номер свидетельства о регистрации транспортного средства (СТС).
data.registrationCertDate
дата регистрационного документа (СТС).
data.bodyCode
номер кузова транспортного средства. null — значение отсутствует или не получено от источника.
data.makeName
марка транспортного средства. null — значение отсутствует или не получено от источника.
data.chassisCode
номер шасси (рамы) транспортного средства. null — значение отсутствует или не получено от источника.
data.registrationDocument
объект со сведениями о регистрационном документе транспортного средства.
data.registrationDocument.date
дата регистрационного документа.
data.registrationDocument.number
номер регистрационного документа.
data.registrationDocument.series
серия регистрационного документа.
data.registrationDocument.type
тип регистрационного документа. null — значение отсутствует или не получено от источника.
data.enginePowerHp
мощность двигателя транспортного средства в лошадиных силах.
data.stateNumber
государственный регистрационный номер транспортного средства.
data.modelName
модель транспортного средства. null — значение отсутствует или не получено от источника.
data.vehicleTypeCode
код типа транспортного средства. null — значение отсутствует или не получено от источника.
data.manufactureYear
год изготовления транспортного средства.
taskid
уникальный идентификатор задачи.
state
Статус задачи: processing — в очереди или обрабатывается; complete — завершена; error — обработана с ошибкой.
taskstart
Дата и время создания задачи; пустая строка, если дата не задана.
taskend
Дата и время завершения задачи; null во время обработки, пустая строка, если дата завершенной задачи не задана.

Ошибки:

Различайте ошибку API-запроса и ошибку выполнения задачи. При ошибке запроса возвращаются error = true и error_msg; error_code может присутствовать в ошибках доступа. При ошибке выполнения задачи текущая версия возвращает state = error, message и data = null, но error = false.

Пример ошибки API-запроса

Ошибка выполнения задачи

Сообщения об ошибках запроса:

Некорректный режим запроса.
Параметр mode отсутствует или отличается от settask/getresult.
Госномер не указан.
Не передан госномер для постановки задачи.
Некорректный госномер.
Переданный госномер не прошел проверку.
Идентификатор задачи не указан.
Не передан taskid для получения результата.
Некорректный идентификатор задачи.
Параметр taskid не является GUID.
Задача не найдена.
Задача с таким идентификатором отсутствует.
Связанная задача не найдена.
Для завершенной задачи не найдена связанная запись с результатом источника.

Неверный ключ, истекший доступ, отсутствие доступа к методу или запрос чужой задачи также приводят к ошибке доступа. Проверить доступ.