Zaloguj sięZacznij za darmo
Platforma deweloperska

Buduj na Transportial

Pełne REST API, App Store SDK, framework webhooków i natywny model danych OTM5. Wszystko, czego potrzebujesz, by budować oprogramowanie logistyczne na platformie, która już działa produkcyjnie.

Czytaj dokumentacjęUzyskaj darmowy dostęp do API
OpenAPI 3.0Standard API
RESTInterfejs HTTP
OTM5Otwarty standard
WebhooksSystem zdarzeń
Transportial REST API
# Uwierzytelnij się kluczem API
Authorization: Bearer <api-key>
GET /api/v1/transport-orders # list & filter orders
POST /api/v1/trips/optimise # VRP trip optimisation
GET /api/v1/vehicles/tracking # live GPS positions
POST /api/v1/webhooks/register # subscribe to events
GET /api/v1/invoices # billing & financials
# App installation token
POST /oauth/token grant_type=client_credentials&installation_id=…
Pełna dokumentacja API, przewodniki i dokumentacja SDK nadocs.transportial.com
Otwórz dokumentację
Serwer MCPPołącz Claude, ChatGPT i Cursor
Serwer MCP
Szybki start

Gotowe w kilka minut

Bez skomplikowanego wdrażania. Zdobądź klucz API, przeczytaj dokumentację i wykonaj pierwsze wywołanie API.

Załóż darmowe konto

Zarejestruj się na portal.otms.transportial.com, bez karty kredytowej. Twój klucz API zostanie wygenerowany od razu.

Przeczytaj dokumentację

Przeglądaj pełną specyfikację OpenAPI 3.0, przewodniki i przykłady kodu na docs.transportial.com.

Wykonaj pierwsze wywołanie API

Użyj klucza API, aby pobrać listę zleceń transportowych, tworzyć tripy lub strumieniować pozycje pojazdów, wszystko przez standardowe REST.

Zbuduj i opublikuj

Zbuduj integrację, wdrożenie white-label lub aplikację do App Store, a następnie zgłoś ją do marketplace Transportial.

Twoje pierwsze wywołanie API:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.transportial.com/v1/transport-orders
Dokumentacja API

Co możesz zbudować z API

Każdy główny zasób Transportial jest dostępny przez REST. Pełny CRUD, filtrowanie, paginacja i zdarzenia webhook.

Zlecenia transportowe

Twórz zlecenia transportowe i zarządzaj nimi

Zarządzanie pełnym cyklem życia: twórz, aktualizuj, przydzielaj i śledź zlecenia transportowe. Filtruj po statusie, dacie, kliencie i nie tylko.

Zobacz dokumentację
Zarządzanie tripami

Optymalizuj i realizuj tripy

Uruchamiaj optymalizację tripów VRP, przydzielaj kierowców i pojazdy, zarządzaj tripami wieloetapowymi i śledź realizację w czasie rzeczywistym.

Zobacz dokumentację
Śledzenie i telemetria

GPS i telemetria IoT na żywo

Strumieniuj na żywo pozycje pojazdów, status kierowców i telemetrię czujników. Integracja z Trimble, ZF Transics i własnymi rozwiązaniami IoT.

Zobacz dokumentację
Webhooki

Subskrybuj zdarzenia w czasie rzeczywistym

Rejestruj webhooki dla ponad 75 typów zdarzeń: utworzenie zlecenia, start tripu, spóźnienie kierowcy, opłacenie faktury i więcej. Payloady podpisane HMAC.

Zobacz dokumentację
Silnik cenowy

Odpytuj i konfiguruj reguły cenowe

Twórz cenniki, stosuj dopłaty paliwowe, uruchamiaj automatyczne fakturowanie. Pełny język zapytań TQL do dynamicznej logiki cenowej.

Zobacz dokumentację
Dokumenty

Generuj dokumenty transportowe

Automatycznie generuj listy przewozowe CMR, dowody dostawy i dokumenty celne z danych zleceń transportowych. Eksport do PDF w zestawie.

Zobacz dokumentację
Użytkownicy i uprawnienia

Zarządzaj użytkownikami i kontrolą dostępu

Ponad 200 nazwanych uprawnień, kontrola dostępu oparta na rolach, SSO SAML 2.0 i uwierzytelnianie JWT z 2FA TOTP. Gotowe dla dużych firm.

Zobacz dokumentację
App Store

Buduj i publikuj aplikacje w marketplace

Użyj App Store SDK, aby osadzać własne panele w dowolnym widoku. Publikuj w marketplace Transportial lub wdrażaj prywatnie.

Zobacz dokumentację
App Store

Rozszerzaj platformę własnymi aplikacjami

Zbuduj aplikację raz i zainstaluj ją dla siebie, jednego klienta lub każdego tenanta Transportial: osadzaj swoje strony w widokach tripów, zleceń i pojazdów, na dashboardzie lub jako stronę menu, i odbieraj podpisane webhooki.

  • Rozszerzenia UI: Twoja strona w izolowanym iframe w slotach tripu, zlecenia, pojazdu, dashboardu lub menu
  • Podpisany token kontekstu mówi Twojej stronie, kto na co patrzy
  • Tokeny instalacyjne OAuth ograniczone do uprawnień zatwierdzonych przez klienta
  • Podpisane webhooki z ponawianiem i dziennikiem doręczeń
  • Aplikacje prywatne przez link instalacyjny lub publiczne w App Store po weryfikacji
  • Własna platforma sandbox z danymi demo i symulowanymi pojazdami
Przewodnik dla twórców aplikacjiZałóż konto deweloperskie
trip-tab.js
// Your page runs in a sandboxed iframe in the trip view
window.parent.postMessage({ type: 'transportial:ready' }, '*')
window.addEventListener('message', ({ data }) => {
if (data.type === 'transportial:context')
await verify(data.token) // trip id, user, platform
})
window.parent.postMessage({ type: 'transportial:resize', height: 480 }, '*')
Framework integracyjny

Połącz dowolny system zewnętrzny

Wbudowany potok integracyjny obsługuje zarządzanie kolejkami, logikę ponowień, śledzenie statusu i obsługę błędów, więc skupiasz się na mapowaniu, a nie na infrastrukturze.

REST API

Pełna specyfikacja OpenAPI 3.0. Uwierzytelnianie kluczem API z limitami zapytań per klucz, listą dozwolonych adresów IP i szczegółowymi logami zapytań.

Serwer FTP i EDI

Wbudowany serwer FTP z parsowaniem plików EDI dla starszych systemów nadawców. Obsługuje EDIFACT, X12 i własne formaty plików płaskich.

Webhooki i zdarzenia

Subskrybuj ponad 75 zdarzeń platformy z payloadami webhooków weryfikowanymi HMAC. Konfigurowalne ponawianie z wykładniczym odstępem.

SSO SAML 2.0

Federacja tożsamości w przedsiębiorstwie z dowolnym IdP SAML 2.0: Azure AD, Okta, Google Workspace i innymi.

Standard OTM5

Natywny model danych OTM5 zapewniający interoperacyjność z szerszym europejskim ekosystemem transportu towarowego.

Własne konektory

Buduj własne konektory integracyjne z SDK frameworka integracyjnego i wdrażaj je u dowolnego tenanta Transportial.

Open source

Tworzone otwarcie

Wierzymy, że najlepsza infrastruktura jest wspólna. Transportial publikuje biblioteki open source, na których działa nasza własna platforma, do darmowego użytku dla każdego dewelopera.

GSJson

KotlinJavaScript

Szybki getter/setter JSON dla JVM i JavaScript

Wydajna biblioteka ścieżek JSON inspirowana GJSON. Odpytuj i modyfikuj JSON ścieżkami w notacji kropkowej, z symbolami wieloznacznymi, filtrami tablic, modyfikatorami i odwołaniami wstecznymi, zarówno w Kotlin/Java, jak i JavaScript/TypeScript.

# Odpytuj zagnieżdżony JSON przejrzystą składnią ścieżek
GSJson.get(json, 'name.first') // → "Tom"
GSJson.get(json, 'friends.[age > "40"].[#.first]') // → ["Dale","Roger","Jane"]
GSJson.get(json, 'children|@reverse|@join') // → "Jack,Alex,Sara"
npm installgsjson
Zobacz na GitHubie
github.com/Transportial

Zasoby dla deweloperów

Wszystko, czego potrzebujesz, by przejść od pomysłu do produkcji.

Dokumentacja API

Pełna specyfikacja OpenAPI 3.0 z interaktywnym Swagger UI. Poznaj każdy endpoint, schemat i kod odpowiedzi.

Przeglądaj dokumentację API

Specyfikacja OpenAPI

Pobierz surową specyfikację OpenAPI w JSON/YAML do generowania kodu, klienckich SDK lub testów integracyjnych.

Pobierz specyfikację

Manifest aplikacji i rozszerzenia UI

Deklaruj uprawnienia, ustawienia, sloty UI i webhooki oraz komunikuj się z portalem z osadzonej strony przez postMessage.

Zobacz przewodnik po aplikacjach

Przewodnik po webhookach

Schematy payloadów, katalog zdarzeń, weryfikacja podpisu HMAC i sandbox do testów.

Czytaj przewodnik po webhookach

Przewodnik po App Store

Przewodnik krok po kroku po budowaniu, zgłaszaniu i utrzymywaniu aplikacji w marketplace Transportial.

Czytaj przewodnik po App Store

Wsparcie dla deweloperów

Napisz do naszego zespołu developer relations z pytaniami technicznymi, prośbą o pomoc w integracji lub zapytaniem o partnerstwo.

Napisz do zespołu

Gotowy do budowania?

Zdobądź darmowy klucz API, przeczytaj dokumentację i wykonaj pierwsze wywołanie w kilka minut.

Czytaj dokumentacjęUzyskaj darmowy dostęp do API