Автор: Если вы держите автосалон в Португалии, пишете про машины или ведёте учёт для небольшой фирмы, вы наверняка слышали слово «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.