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. Це тримає все чесним щодо тих, хто читає вашу сторінку.
Чи можна довіряти даним?
Це ті самі дані, на яких працює наш власний португальський сайт, тож нам самим важливо тримати їх точними. Ставтеся до діапазону справедливої ціни як до добре обґрунтованого орієнтира, а до податку — як до надійної оцінки для бюджету, а не як до офіційної оцінки чи податкового нарахування.