ImportOS Data · dla programistów
BetaOdprawa celna, ceny i wyszukiwanie jako API i serwer MCP
Podłącz wyliczanie kosztów, przepisy celne ze źródłami, dekodowanie VIN i znormalizowane wyszukiwanie do własnych systemów lub asystentów AI. Beta: endpointy są jeszcze w budowie.
Beta: endpointy są w budowie, schematy mogą się zmienić przed wydaniem.
Możliwości
Co jest w API
REST API v1
- Landed cost, cena rynkowa, dekodowanie VIN, wyszukiwanie ogłoszeń, przepisy celne, kursy
- Wszystko pod kluczem API, z rozdzieleniem uprawnień (scopes)
- Odpowiedzi z objaśnieniami i linkami do źródeł przepisów
Serwer MCP
- Siedem narzędzi dla agentów AI: wyliczenie, cena, VIN, wyszukiwanie, przepisy, leady, status transakcji
- Streamable HTTP pod tym samym kluczem API
- Opisy narzędzi napisane dla LLM: kiedy wywołać i z jakimi parametrami
Webhooki
- Zdarzenia transakcji, płatności i dokumentów
- Podpis HMAC do weryfikacji nadawcy
Klucze i limity
- Limity zależne od planu; po przekroczeniu odpowiedź 429 z nagłówkiem Retry-After
- Licznik wywołań i raport wykorzystania w Desk
OpenAPI i SDK
- Specyfikacja OpenAPI 3.1 wygenerowana ze schematów walidacji
- Interaktywna dokumentacja Scalar pod /docs
- SDK TypeScript wygenerowane ze specyfikacji
Dane Twojej firmy
- Kontakty, transakcje, etapy, generowanie dokumentów, przesyłki
- Zapis wymaga osobnego dostępu write:deals
Endpointy
REST API v1
Lista endpointów odpowiada specyfikacji. Beta: ścieżki i schematy mogą się zmienić przed wydaniem, ostateczny opis będzie w OpenAPI.
| Endpoint | Co robi | Dostęp |
|---|---|---|
| POST/v1/landed-cost | Koszt „pod klucz” z pozycjami, objaśnieniami i źródłami | klucz API |
| GET/v1/market-price | Wycena rynkowa według marki, modelu, roku i rynku | klucz API |
| GET/v1/vin/{vin} | Dekodowanie VIN i znane sprzedaże z pamięci podręcznej | klucz API |
| GET/v1/listings/search | Znormalizowane wyszukiwanie w źródłach (Scout) | klucz API |
| GET/v1/rules/{country} | Obowiązujące przepisy celne kraju ze źródłami | klucz API |
| GET/v1/fx | Kursy walut | klucz API |
| POST/v1/contacts | Tworzenie i zarządzanie kontaktami | write:deals |
| POST/v1/deals | Tworzenie i odczyt transakcji | write:deals |
| POST/v1/deals/{id}/stage | Zmiana etapu transakcji | write:deals |
| POST/v1/documents/generate | Generowanie dokumentu z szablonu | write:deals |
| POST/v1/shipments | Przesyłki i śledzenie | write:deals |
Wszystkie wywołania wymagają klucza API. Limity zależą od planu.
Przykład
Zapytanie o wyliczenie kosztu
Treść zapytania to ten sam wejściowy obiekt, który przyjmuje kalkulator rdzenia. Poniżej prawdziwy wynik tego wyliczenia.
Zapytanie
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"}'Odpowiedź (skrócona)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
}Opakowanie odpowiedzi endpointu może się różnić: ostateczne schematy będą w OpenAPI. Wyliczenie wykonano na kursach demo i typowych stawkach.
MCP
Podłącz ImportOS do asystenta AI
Serwer MCP jest dostępny pod tym samym kluczem API. Oto narzędzia, które zobaczy asystent.
calculate_landed_cost
Liczy koszt auta „pod klucz” w kraju docelowym. Wywołuj, gdy potrzebna jest pełna cena importu konkretnego lotu.
estimate_market_price
Szacuje cenę rynkową podobnych aut. Wywołuj do oceny marży przy odsprzedaży.
decode_vin
Dekoduje VIN i zwraca znane sprzedaże z pamięci podręcznej.
search_listings
Szuka ogłoszeń w podłączonych źródłach w znormalizowanej postaci.
get_customs_rules
Zwraca obowiązujące przepisy celne kraju z linkami do źródeł.
create_lead
Tworzy lead w Desk. Dla agentów sprzedażowych rozmawiających z klientami.
get_deal_status
Zwraca status transakcji dla asystenta klienta.
Adres serwera i przykład konfiguracji dla klientów MCP pojawią się wraz z wydaniem; dodamy też pliki do katalogów MCP.
Webhooki
Zdarzenia, które można subskrybować
Każde żądanie jest podpisane HMAC, abyś mógł zweryfikować nadawcę.
- deal.stage_changed
- payment.received
- document.signed
Plany API
Osobne plany dla programistów
Wstępne warunki ze specyfikacji; ostateczne plany i ceny zostaną potwierdzone przed wydaniem.
Free
Za darmo
100 wywołań miesięcznie
Dev
49 $ / mies.
10 000 wywołań miesięcznie
Business
199 $ / mies.
100 000 wywołań miesięcznie
Ponad limit planu obowiązuje opłata za użycie. API wchodzi też w plan ImportOS Business.
Jak to działa
Jak zacząć
- 1
Pobierz klucz
Wygeneruj klucz API w Desk, w ustawieniach API.
- 2
Wykonaj zapytanie
Wywołaj endpoint REST albo podłącz serwer MCP do swojego asystenta.
- 3
Subskrybuj zdarzenia
Skonfiguruj webhooki i weryfikuj podpis HMAC.
Pytania
Najczęstsze pytania
Czy API jest gotowe na produkcję?
Nie, to beta: endpointy są jeszcze w budowie, a schematy mogą się zmieniać. Nie opieraj na nich krytycznych procesów przed wydaniem.
Czy są limity?
Tak, limity zależą od planu. Po przekroczeniu serwer odpowiada 429 z nagłówkiem Retry-After.
Skąd dane dla /v1/rules?
Z tych samych datowanych przepisów, których używa kalkulator; każdy parametr ma link do źródła i oznaczenie, czy potwierdzono go oficjalnym źródłem.
Podłącz wyliczenia do swoich systemów
API wchodzi w Business ($199 miesięcznie), planowany jest też osobny plan dla programistów.