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ę](https://docs.transportial.com)[Uzyskaj darmowy dostęp do API](https://portal.otms.transportial.com/auth/developer/register)

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 na[docs.transportial.com](https://docs.transportial.com)

[Otwórz dokumentację](https://docs.transportial.com)

Serwer MCPPołącz Claude, ChatGPT i Cursor

[Serwer MCP](/pl/mcp)

Szybki start

## Gotowe w kilka minut

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

01

### Załóż darmowe konto

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

02

### Przeczytaj dokumentację

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

03

### 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.

04

### 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ę](https://docs.transportial.com/examples/managing-transport-orders)

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ę](https://docs.transportial.com/guides/trips-and-planning)

Ś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ę](https://docs.transportial.com/examples/fleet-tracking)

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ę](https://docs.transportial.com/guides/webhooks-and-events)

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ę](https://docs.transportial.com/guides/pricing-and-charges)

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ę](https://docs.transportial.com/guides/documents-and-files)

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ę](https://docs.transportial.com/guides/authentication)

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ę](https://docs.transportial.com/guides/app-store)

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 aplikacji](https://docs.transportial.com/guides/app-store)[Załóż konto deweloperskie](https://portal.otms.transportial.com/auth/developer/register)

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 install`gsjson`

[Zobacz na GitHubie](https://github.com/Transportial/GSJson)

[github.com/Transportial](https://github.com/Transportial)

## Zasoby dla deweloperów

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

[Dokumentacja APIPełna specyfikacja OpenAPI 3.0 z interaktywnym Swagger UI. Poznaj każdy endpoint, schemat i kod odpowiedzi.Przeglądaj dokumentację API](https://docs.transportial.com/apis)[Specyfikacja OpenAPIPobierz surową specyfikację OpenAPI w JSON/YAML do generowania kodu, klienckich SDK lub testów integracyjnych.Pobierz specyfikację](https://docs.transportial.com/%5Fspec/apis/index.json)[Manifest aplikacji i rozszerzenia UIDeklaruj uprawnienia, ustawienia, sloty UI i webhooki oraz komunikuj się z portalem z osadzonej strony przez postMessage.Zobacz przewodnik po aplikacjach](https://docs.transportial.com/guides/app-store)[Przewodnik po webhookachSchematy payloadów, katalog zdarzeń, weryfikacja podpisu HMAC i sandbox do testów.Czytaj przewodnik po webhookach](https://docs.transportial.com/guides/webhooks-and-events)[Przewodnik po App StorePrzewodnik krok po kroku po budowaniu, zgłaszaniu i utrzymywaniu aplikacji w marketplace Transportial.Czytaj przewodnik po App Store](https://docs.transportial.com/guides/app-store)[Wsparcie dla deweloperówNapisz do naszego zespołu developer relations z pytaniami technicznymi, prośbą o pomoc w integracji lub zapytaniem o partnerstwo.Napisz do zespołu](mailto:developers@transportial.com)

## Gotowy do budowania?

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

[Czytaj dokumentację](https://docs.transportial.com)[Uzyskaj darmowy dostęp do API](https://portal.otms.transportial.com/auth/developer/register)

---
Canonical page: https://transportial.com/pl/developers
