TransparentВы наверняка слышали слово «API» и кивали, хотя вам его так никто и не объяснил. Вот простая версия — на примере нашего собственного бесплатного автомобильного API для Португалии. Диплома по информатике не потребуется.
Что такое API на самом деле
Представьте ресторан. Вы сидите за столиком (это ваш сайт, ваша таблица, приложение в телефоне). Вы не идёте на кухню готовить — вы говорите официанту, что хотите, и он приносит блюдо с кухни. API — это тот самый официант. Это одна программа вежливо просит что-то у другой программы и получает аккуратный ответ, автоматически, без того чтобы человек копировал и вставлял вручную.
Поэтому когда мы говорим «API TransparentCars», мы имеем в виду вот что: наши системы отдают данные об автомобилях прямо вашим системам. Вы спрашиваете «какая справедливая цена на Renault Clio 2015 года с пробегом 118 000 км?» — и получаете число за доли секунды, то же самое, которое использует наш собственный сайт.
Что бесплатный API TransparentCars даёт вам в Португалии
TransparentCars — это местный португальский продавец подержанных автомобилей. Мы построили свой сайт поверх небольшого честного сервиса данных и открыли этот же сервис всем. Он бесплатный и не требует ключа — без регистрации, без токена, без счёта. Вы просто обращаетесь к нему. Вот что он умеет рассказать:
- Справедливую цену автомобиля. Задаёте марку, модель, год и пробег — и получаете диапазон справедливой цены: нижнюю, среднюю и верхнюю границу, построенный по сопоставимым машинам, которые продаются в Португалии прямо сейчас. Это тот же движок, что и за нашим инструментом справедливой цены. Он честно отвечает на один вопрос: разумна ли запрошенная цена или нет.
- Годовой транспортный налог и стоимость содержания. Задаёте объём двигателя, CO₂, тип топлива и год первой регистрации — и получаете годовой налог IUC в евро: во что обходится просто держать машину на дороге по закону. Электромобили возвращаются как освобождённые. Это та же арифметика, что и в нашем публичном калькуляторе налога.
- Каталог подержанных машин. Автомобили, которые у нас действительно в продаже, — марка, модель, год, пробег, цена, фотографии — те же объявления, что вы видите на сайте, доступные как чистые данные, которые можно подтянуть на свою страницу или в таблицу.
- Список марок и моделей, которые понимает инструмент справедливой цены, чтобы вы всегда спрашивали в правильном написании.
Каждый ответ — это простые числа или публичные данные объявлений, без какой-либо личной информации.
Кому это реально нужно и зачем
Два бытовых примера делают это наглядным.
Небольшой местный автосалон. Допустим, у вас маленькая площадка на пятнадцать машин. Вы могли бы показывать небольшой значок «справедливая цена» на каждом объявлении — «в пределах справедливого диапазона для Португалии» — подтянутый вживую из наших данных оценки. Нервничающему покупателю это с одного взгляда говорит, что вы не берёте цену с потолка. Большой ИТ-отдел не нужен: один разработчик подключает это один раз.
Блогер, бухгалтер или мелкий предприниматель. Может, вы пишете про машины или помогаете клиентам считать бюджет на автомобиль. Вместо того чтобы вручную смотреть налог для двадцати разных машин, вы можете пустить числа прямо в таблицу. Спросили один раз — и годовой IUC для каждой машины заполняется сам. То же и со столбцом справедливой цены рядом со списком машин, которые вы сравниваете.
Нужно ли быть программистом? Вариант без кода
Чаще всего да — первое подключение делает кто-то технический — но не всегда. Современные таблицы (например, Google Таблицы) умеют тянуть данные прямо с веб-адреса, так что аккуратный не-программист может поставить значение налога или справедливой цены в ячейку, не написав настоящего кода. Готового виджета в духе «вставьте этот блок на свой сайт» мы пока не предлагаем; если нужно именно это, честный ответ сегодня такой: программист потратит час, а не неделю. А если вы предпочли бы, чтобы сторону справедливой цены мы взяли на себя, самый простой путь — продать свою машину или разместить её у нас напрямую.
Техническая часть, коротко
Для программиста, которому вы это в итоге передадите: есть полноценная страница API для разработчиков с машиночитаемым описанием OpenAPI по адресу transparent.pt/openapi.yaml, чтобы его инструменты автоматически понимали каждый endpoint. Адреса выглядят так: transparent.pt/api/public/valuation и transparent.pt/api/public/cars. Код открытый, на GitHub (репозитории api и mcp в transparentpt). Есть щедрый лимит честного использования на посетителя — с запасом для обычного сайта или таблицы, — а если вы его превысите, сервис просто попросит немного подождать. Если же вы хотите, чтобы ваши инструменты или ИИ-ассистент общались с нами разговором, у нас есть и MCP-сервер — но это отдельная история, рассказанная в нашей статье про MCP.
Честный мелкий шрифт
Мы не нейтральная служба, которая делает вид, что ей всё равно. TransparentCars продаёт подержанные автомобили в Португалии, и этот бесплатный API работает на тех же данных, которыми пользуемся мы сами. Он бесплатен по лицензии Creative Commons, которая всего лишь просит указывать «TransparentCars» как источник там, где вы показываете числа. Диапазон справедливой цены построен на реальных запрашиваемых ценах, это не официальная оценка, а сумма налога — хорошо поддерживаемая оценка для планирования, а не счёт из налоговой. Пользуйтесь этим, чтобы принять здравое решение, а не чтобы выиграть дело в суде.
Частые вопросы
API TransparentCars правда бесплатный и без ключа?
Да. Без аккаунта, без API-ключа, без оплаты. Вы (или ваш разработчик) обращаетесь к веб-адресу и получаете JSON в ответ. Единственное ограничение — потолок честного использования на посетителя, чтобы никто не молотил по сервису; обычное использование до него не доходит.
Нужно ли указывать TransparentCars?
Там, где вы показываете наши числа, — да, достаточно простого «источник: TransparentCars», как просит лицензия Creative Commons. Это держит всё честным по отношению к тем, кто читает вашу страницу.
Данным можно доверять?
Это те же данные, на которых работает наш собственный португальский сайт, так что нам самим важно держать их точными. Относитесь к диапазону справедливой цены как к хорошо обоснованному ориентиру, а к налогу — как к надёжной оценке для бюджета, а не как к официальной оценке или налоговому начислению.