Автор: Якщо ви тримаєте автосалон у Португалії, пишете про автомобілі чи ведете облік для невеликої фірми, ви напевно чули слово «API» й вирішили, що це лише для програмістів. Це не так. У цій статті ми простою мовою пояснюємо, що таке безкоштовний API автомобільних податків Clara Carros, що він робить і як ним користуватися, навіть якщо ви жодного разу не писали код.
Що таке API, простими словами
API — це просто спосіб для одного сайту чи застосунку автоматично запитати дані в іншого. Уявіть ресторан: офіціант відносить ваше замовлення на кухню й приносить вам страву. Ви не заходите на кухню й вам не потрібно вміти готувати. API — це той самий офіціант: ваш сайт надсилає запит («який податок на ввезення цього авто?»), наш API знаходить відповідь і повертає її за секунди, і нікому не доводиться рахувати вручну.
Що дає наш API — безкоштовно й без реєстрації, у Португалії
API від Clara Carros безкоштовний, не потребує реєстрації та ключа доступу й дозволяє близько 60 податкових запитів на хвилину — більш ніж достатньо для більшості випадків. Він повертає дані, розраховані на португальський ринок:
- Податок на ввезення (ISV) — податок на транспортний засіб, який сплачують під час ввезення авто до Португалії. Адреса:
/api/public/isv. - Ринкові оцінки — оцінка вартості автомобіля. Адреса:
/api/public/valuation. - Наш каталог автомобілів — авто, що є в наявності. Адреса:
/api/public/cars. - Офіційні переліки марок і моделей — нормалізовані назви, завжди написані однаково. Адреса:
/api/public/car_refs.
Також ми надаємо розрахунок річного податку на володіння (IUC) через наші калькулятори. Готові до використання інструменти можна переглянути на сторінках розрахунку ISV та розрахунку IUC.
Кому це потрібно й навіщо
API потрібен не всім — він для тих, кому ті самі цифри потрібні постійно й завжди точно. Кілька реальних прикладів:
- Автосалон або імпортер, який хоче показувати поруч із кожним оголошенням, яким буде ISV на це авто, — не рахуючи вручну для кожного автомобіля.
- Блогер або бухгалтер, якому потрібно підтягнути податкові суми в таблицю чи статтю, а не копіювати їх по одній.
- Невеликий застосунок або інструмент, що допомагає людям вирішити, чи варто ввозити авто, одразу показуючи розмір податку.
А якщо я не вмію програмувати? Варіанти без коду
Гарна новина: у більшості випадків вам взагалі не доведеться торкатися API напряму. У нас є готові варіанти:
- Вбудовуваний віджет калькулятора (iframe) — ви вставляєте невеликий блок коду на свій сайт, і калькулятор з’являється там та працює. Це найпростіший спосіб.
- Версія на JavaScript, дружня до SEO — схожа на віджет, але з умістом, видимим для Google, що допомагає вашому сайту знаходитися в пошуку.
- Офіційний плагін для WordPress — якщо ваш сайт зроблено на WordPress, ви встановлюєте плагін і використовуєте простий шорткод
[claracars_isv], щоб розмістити калькулятор на будь-якій сторінці. Отримати офіційний плагін можна в каталозі WordPress.
Для більш технічно підкованих — або якщо ви працюєте з програмістом — ми також надаємо специфікацію OpenAPI 3.1, готову до тестування колекцію Postman і калькулятори на Python з відкритим кодом (ліцензія MIT) на GitHub. Усе це зібрано на нашій сторінці API для розробників.
Чесне зауваження
Так, це справді безкоштовно. Натомість ми просимо лише про одне: коли ви використовуєте віджет на своєму сайті, залишайте видимою згадку про Clara Carros. І ми хочемо бути чесними щодо того, хто ми такі: Clara Carros — це імпортер і продавець автомобілів у Португалії. Ми створили ці безкоштовні інструменти, бо вони корисні нам самим і бо віримо: зрозумілі цифри допомагають усім ухвалювати виваженіші рішення.
Калькулятор та інструменти дають вам цифри. Якщо вам зручніше, щоб ми самі знайшли, перевірили, привезли й передали вам авто, перегляньте наші послуги — імпорт під ключ та підбір автомобіля.
Часті запитання
Мені справді не потрібно реєструватися чи платити?
Ні. API безкоштовний і без ключа доступу. Ви можете почати користуватися ним одразу, у межах приблизно 60 податкових запитів на хвилину.
Я не вмію програмувати. Чи можу я все одно цим користуватися?
Так. Використовуйте вбудовуваний віджет, версію на JavaScript або плагін для WordPress. Жоден із них не потребує навичок програмування — достатньо вставити невеликий блок коду або використати шорткод [claracars_isv].
Де дізнатися більше?
У нас є споріднені статті про наш MCP-сервер для ChatGPT та інших ШІ-асистентів, про плагін для WordPress і про розширення для Chrome, що показує ISV прямо на mobile.de.