Перейти до змісту
ImportOS
Почати тріал

ImportOS Data · для розробників

Бета

Розмитнення, ціни та пошук як API і як MCP-сервер

Підключіть розрахунок собівартості, митні правила з джерелами, декод VIN і нормалізований пошук до власних систем або до AI-асистентів. Бета: ендпоінти ще будуються.

14 днів безкоштовноДивитись тарифи

Бета: ендпоінти будуються, схеми можуть змінитися до релізу.

Можливості

Що в API

REST API v1

  • Landed cost, ринкова ціна, декод VIN, пошук оголошень, митні правила, курси
  • Усе під API-ключем, із розмежуванням доступу (scopes)
  • Відповіді з поясненнями й посиланнями на джерела правил

MCP-сервер

  • Сім інструментів для AI-агентів: розрахунок, ціна, VIN, пошук, правила, ліди, статус угоди
  • Streamable HTTP за тим самим API-ключем
  • Описи інструментів написані для LLM: коли викликати й з якими параметрами

Вебхуки

  • Події угод, платежів і документів
  • Підпис HMAC для перевірки відправника

Ключі та ліміти

  • Ліміти за планом; при перевищенні відповідь 429 із заголовком Retry-After
  • Лічильник викликів і звіт використання в Desk

OpenAPI і SDK

  • Специфікація OpenAPI 3.1, згенерована зі схем валідації
  • Інтерактивна документація Scalar на /docs
  • TypeScript SDK, згенерований зі специфікації

Дані вашої компанії

  • Контакти, угоди, стадії, генерація документів, відправлення
  • Запис потребує окремого доступу write:deals

Ендпоінти

REST API v1

Список ендпоінтів відповідає специфікації. Бета: шляхи й схеми можуть змінитися до релізу, остаточний опис буде в OpenAPI.

ЕндпоінтЩо робитьДоступ
POST/v1/landed-costСобівартість «під ключ» зі статтями, поясненнями й джереламиAPI-ключ
GET/v1/market-priceОцінка ринкової ціни за маркою, моделлю, роком і ринкомAPI-ключ
GET/v1/vin/{vin}Декод VIN і відомі продажі з кешуAPI-ключ
GET/v1/listings/searchНормалізований пошук по джерелах (Scout)API-ключ
GET/v1/rules/{country}Чинні митні правила країни з джереламиAPI-ключ
GET/v1/fxКурси валютAPI-ключ
POST/v1/contactsСтворення й керування контактамиwrite:deals
POST/v1/dealsСтворення й читання угодwrite:deals
POST/v1/deals/{id}/stageЗміна стадії угодиwrite:deals
POST/v1/documents/generateГенерація документа із шаблонуwrite:deals
POST/v1/shipmentsВідправлення й трекінгwrite:deals

Усі виклики потребують API-ключа. Ліміти залежать від плану.

Приклад

Запит на розрахунок собівартості

Тіло запиту — той самий вхід, який приймає калькулятор ядра. Нижче — справжній результат цього розрахунку.

Запит

curl -X POST "$IMPORTOS_API/v1/landed-cost" \
  -H "Authorization: Bearer $IMPORTOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_price":8000,"auction":"copart","vehicle":{"vin":"4T1B11HK5JU000001","year":2018,"fuel":"petrol","engine_cc":2487,"damage":"FRONT END"},"from":{"auction_yard":"NJ - TRENTON"},"to":{"country":"PL"},"fee_model":{"model":"fixed","amount":700,"currency":"USD"},"target_currency":"USD","date":"2026-10-17"}'

Відповідь (скорочено)total: 20 958 $

{
  "country": "PL",
  "currency": "USD",
  "total": 20957.7,
  "items": [
    {
      "kind": "lot_price",
      "code": "lot_price",
      "amountInTarget": 8000,
      "verified": true
    },
    {
      "kind": "auction_fee",
      "code": "copart.fees",
      "amountInTarget": 1210,
      "verified": true
    },
    {
      "kind": "inland_us",
      "code": "inland_us",
      "amountInTarget": 250,
      "verified": true
    }
  ],
  "...": "+12",
  "warnings": "[4]",
  "rulesVersion": "PL@2026-07-01",
  "confidence": 0.73
}

Обгортка відповіді ендпоінта може відрізнятися: остаточні схеми будуть в OpenAPI. Розрахунок виконано на демо-курсах і типових тарифах.

MCP

Підключіть ImportOS до AI-асистента

MCP-сервер доступний за тим самим API-ключем. Ось інструменти, які бачитиме асистент.

calculate_landed_cost

Рахує собівартість авто «під ключ» у країні призначення. Викликати, коли потрібна повна ціна імпорту для конкретного лота.

estimate_market_price

Оцінює ринкову ціну схожих авто. Викликати для оцінки маржі перепродажу.

decode_vin

Розшифровує VIN і повертає відомі продажі з кешу.

search_listings

Шукає оголошення по підключених джерелах у нормалізованому вигляді.

get_customs_rules

Повертає чинні митні правила країни з посиланнями на джерела.

create_lead

Створює лід у Desk. Для агентів-продавців, що спілкуються з клієнтами.

get_deal_status

Повертає статус угоди для клієнтського асистента.

Адреса сервера й приклад налаштування для клієнтів MCP з'являться з релізом; ми додамо файли для каталогів MCP.

Вебхуки

Події, на які можна підписатися

Кожен запит підписується HMAC, щоб ви могли перевірити відправника.

  • deal.stage_changed
  • payment.received
  • document.signed

Плани API

Окремі плани для розробників

Попередні умови за специфікацією; остаточні плани й ціни буде підтверджено до релізу.

Free

Безкоштовно

100 викликів на місяць

Dev

49 $ / міс

10 000 викликів на місяць

Business

199 $ / міс

100 000 викликів на місяць

Понад ліміт плану діє оплата за використанням. API також входить у тариф ImportOS Business.

Як це працює

Як почати

  1. 1

    Отримайте ключ

    Згенеруйте API-ключ у Desk, у розділі налаштувань API.

  2. 2

    Зробіть запит

    Викличте REST-ендпоінт або підключіть MCP-сервер до свого асистента.

  3. 3

    Підпишіться на події

    Налаштуйте вебхуки й перевіряйте підпис HMAC.

Питання

Часті запитання

Чи готове API до продакшену?

Ні, це бета: ендпоінти ще будуються, а схеми можуть змінюватися. Не будуйте на них критичні процеси до релізу.

Чи є ліміти?

Так, ліміти залежать від плану. При перевищенні сервер відповідає 429 із заголовком Retry-After.

Звідки дані для /v1/rules?

З тих самих датованих правил, що використовує калькулятор; кожен параметр має посилання на джерело й позначку, чи підтверджено його офіційним джерелом.

Підключіть розрахунки до своїх систем

API входить у Business ($199 на місяць), також планується окремий тариф для розробників.

14 днів безкоштовноДивитись тарифи