Документация по работе с API Электронный ПТСHTTPS GET запрос: https://api-cloud.ru/api/elpts.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| pts | Получение информации о электронном ПТС
🔑 Вид электронного паспорта 🔑 Статус электронного паспорта 🔑 Сведения об уплате утилизационного сбора 🔑 Сведения о выпуске (таможенное оформление) 🔑 Таможенные ограничения 🔑 Ограничения (обременения) за исключением таможенных (РФ) 🔑 Сведения о последнем регистрационном действии |
Обязательные vin - VIN номер транспортного средства Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
function get_rez($url) {
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ
$res = curl_exec($ch);
curl_close($ch);
return $res;
}
$data = [
'type' => 'Тип запроса (type)',
...
Необходимы для запроса параметры
...
'token' => 'Токен',
];
// Структурированная ссылка для GET запроса
$url = 'https://api-cloud.ru/api/elpts.php?' . http_build_query($data);
$data = get_rez($url); // Результат ответа (JSON)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
https://api-cloud.ru/api/elpts.php?type=pts&vin=XKN0A1000L1000003&token=53ba1b7a55abbB014aa97eff3a522079
{
"status":200, // Статус ответа
"found":true, // Результат найден
"rez":{
"type":"Электронный паспорт транспортного средства", // Вид электронного паспорта
"statuspts":"действующий", // Статус ПТС
"displosal_fee":"РФ уплачен", // Сведения об уплате утилизационного сбора
"vipusk":"Отсутствуют", // Сведения о выпуске (таможенное оформление)
> Известные варианты значения: Отсутствуют, Имеются
"custenc":"Отсутствуют", // Таможенные ограничения
"restrictions":"ОТСУТСТВУЮТ", // Ограничения (обременения) за исключением таможенных (РФ)
> Известные варианты значения: ОТСУТСТВУЮТ, СВЕДЕНИЯ ОБ ОГРАНИЧЕНИЯХ ОТСУТСТВУЮТ
"regAction":"РФ - Постановка на регистрационный учет (23.11.2020)" // Сведения о последнем регистрационном действии
> Известные варианты значения: РФ - Постановка на регистрационный учет (дата), РФ - Снятие с регистрационного учета (дата), Отсутствуют
},
"inquiry":{
"price":0.6,
"balance":1153.43,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed":7,
"attempts":1
}
}
Пример успешного ответа от API когда ПТС не найден
{
"status":200, // Статус ответа
"found":false, // Результат не найден
"rez":[
],
"inquiry":{
"price":0.6,
"balance":1153.43,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed":11,
"attempts":1
}
}
{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Что делать в такоем случае? Повторите запрос.
| дата | что изменилось |
|---|
| код (error) | Описание ошибки (message) |
|---|---|
| 888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
| 766 | MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры |
| 602 | TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса |
| 504 | TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой |
| 503 | TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе |
| 502 | MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token |
| 501 | MISSING_REQUIRED_VIN_PARAMETER Отсутствует параметр vin или указан неверно |
| 500 | MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type |
| 499 | WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа. |
| 498 | TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс. |
| 460 | NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры |
| 456 | MAX_LIMIT Превышено количество одновременных соединений (потоки) |
| 404 | TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
| 123 | IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК |
| 111 | PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}