Для розробників
ImportOS Data: REST API (OpenAPI 3.1), MCP-сервер для AI-агентів, вебхуки, TypeScript SDK.
ImportOS Data — публічний REST API та MCP-сервер для розробників і AI-агентів: вартість «під ключ», ринкова ціна, декодування VIN, нормалізований пошук оголошень, митні правила та курси валют. Один API-ключ працює і для REST, і для MCP.
Швидкий старт
API-ключ, перший запит POST /v1/landed-cost, потім той самий розрахунок через MCP у Claude Desktop.
Автентифікація та ліміти
Ключі, scopes, rate limit, формат помилок problem+json.
MCP
Claude Desktop, ChatGPT, Cursor, Claude Code. Інструменти та їхні вхідні поля.
Довідник API
Усі ендпоінти, згенеровані з openapi.json.
Що є
| Можливість | Сторінка | Стан |
|---|---|---|
| REST: landed cost, ринкова ціна, VIN, пошук, митні правила, курси | Довідник API | Бета |
| MCP-сервер: 5 інструментів | MCP | Бета OAuth для ChatGPT немає |
| TypeScript SDK | SDK | Бета усередині monorepo; публікації в npm ще немає |
| Вебхуки тенанта з підписом HMAC | Вебхуки | У розробці доставка й підпис готові, реєстрація вебхука через API чи Desk ні |
CRUD угод і контактів (write:deals) | У розробці | |
| Embed-віджет калькулятора | Віджет | У розробці |
| Джерела Scout | Джерела | згенеровано з реєстру |
| Каталог інтеграцій | Інтеграції | згенеровано з коду |
Принципи
- Оцінка, а не пропозиція. Суми є оцінками. Ставки без підтвердження офіційним джерелом мають
verified: falseу відповіді й попередження (warnings), їх треба показувати користувачеві. - Чесні порожні відповіді. Якщо даних немає, API повертає
nullіsample_size: 0, а не нуль. - Збої джерел не валять запит. Заблоковане чи зламане джерело потрапляє в
errors[]відповіді пошуку. - Стабільні помилки. Усі помилки —
application/problem+jsonзі стабільним полемcode.