Transportial OTMS API (0.9.2)

Download OpenAPI description
Languages
Servers
Mock server
https://docs.transportial.com/_mock/apis/
Test environment
https://test.api.otms.transportial.com/api/
Production
https://api.otms.transportial.com/api/

Transportial

Our full API documentation can be found here for OTMS. It describes our endpoints and the way we accept data.

Authentication

You can authenticate users by a login call and sending their token in the Authorization header.

OTM5

Our API is fully supportive of the OTM5 data structure. You can send and receive those objects in the exact definition. In our documentation you will find our other objects and you don't need to use Associations, we do return that structure however.

ServiceCard

Object describing a geographic ServiceCard. A ServiceCard can either be a point or an area.

Operations

Tire

Object describing a geographic Tire. A Tire can either be a point or an area.

Operations

Action

Actions are dynamic entities that are able to couple together various static entities at a certain moment in time. For instance a Load action couples together a Consignment and a Vehicle at the moment the Loading happens.

Operations

Actor

Actors can be stacked and constrain different activities in their context

Operations

Charge

Charges

Operations

Invoice

Invoices

Operations

LedgerEntry

LedgerEntry ...

Operations

Payout

Payouts

Operations

Plan

Plans

Operations

Quote

Quotes

Operations

Administration

Administrations can be stacked and constrain different activities in their context

Operations

Transaction

Transactions

Operations

Alert

Object describing a geographic alert. A alert can either be a point or an area.

Operations

Publisher

Object describing a geographic publisher. A publisher can either be a point or an area.

Operations

App

Object describing a geographic app. A app can either be a point or an area.

Operations

Attribute

A generic entity that can help in defining other entities properties

Operations

Ban

Object describing a geographic Ban. A Ban can either be a point or an area.

Operations

Board

Boards contain Lanes and might represent a module of a project or a project itself

Operations

Booking

Object describing a geographic booking. A booking can either be a point or an area.

Operations

Business

Business is a base entity that describes a companies information. Thiis entity is used for contracts, clients, invoices, quotes, etc. It can be any type of relation you do business with.

Operations

Camera

A Camera

Operations

CapacityContract

The CapacityContract is the entity to model a contract of a purchase of certain amount of scheduled capacity.

Operations

Capacity

A capacity models the amount of cargo, a schedule can deliver.

Operations

Certificate

Object describing a geographic Certificate. A Certificate can either be a point or an area.

Operations

Chat

Sending messages to users grouped by rooms

Operations

MessageTemplate

MessageTemplates can be stacked and constrain different activities in their context

Operations

Chauffeur

Chauffeurs are the people who are responsible for controlling a Vehicle. They have schedules, planning and legal responsibilities.

Operations

Complaint

Object describing a geographic Complaint. A Complaint can either be a point or an area.

Operations

Consignment

Consignments can be stacked and constrain different activities in their context

Operations

Constraint

Constraints can be stacked and constrain different activities in their context

Operations

Contract

Contracts

Operations

Damage

Object describing a geographic damage. A damage can either be a point or an area.

Operations

Document

Documents are the base entities to handle all types of external data files and the references to them

Operations

Event

Events - like actions - model dynamic entities that couple various static entities at a certain moment in time. Events are used for either real-time updates, or updates on earlier provided data. Notice that in both event types these are updates on earlier provided data, whereas actions are usually used together with the entities they dynamically couple.

Operations

Feedback

Feedbacks

Operations

File

File management. Upload, retrieve and download files. Categorized by it's purpose.

Operations

Fleet

Fleets can be stacked and constrain different activities in their context

Operations

General

General reference data sets like Languages, Currencies etc. and functions

Operations

Goods

Goods are the items to be transported as part of a consignment. Goods can be divided into two sub-types of goods, depending on the use case and the level of detail. Goods either consists of items, describing the actual goods to be transported. Or a transport equipment, which is equipment used to carry the actual goods to be transported. Transport equipment is (usually) a means to an end, not something that needs to be transported on itself, such as pallets.

Operations

TransportEquipment

TransportEquipment are the items to be transported as part of a consignment. TransportEquipment can be divided into two sub-types of transportEquipment, depending on the use case and the level of detail. TransportEquipment either consists of items, describing the actual transportEquipment to be transported. Or a transport equipment, which is equipment used to carry the actual transportEquipment to be transported. Transport equipment is (usually) a means to an end, not something that needs to be transported on itself, such as pallets.

Operations

Insights

All the insights you need can be gathered from these endpoints

Operations

Integration

An Integration is the connection for 2 systems. An integration can be configured and enabled through this object. It can also configure the entire connection or it can be pre-configured.

Operations

Lane

A lane contains a location and status of a todo task.

Operations

ToDo

A lane contains a location and status of a todo task.

Operations

Location

Object describing a geographic location. A location can either be a point or an area.

Operations

Mail

Mails can be stacked and constrain different activities in their context

Operations

Management

The management overviews

Operations

MessageAutomation

Message-Automations are communication automation connectors that can use events

Operations

Notification

Notification endpoint to notify people, groups or the entire user base of things they might want to know or need to know

Operations

Platform

Platforms can be stacked and constrain different activities in their context

Operations

SAML

SAML Configuration for Single-SignOn(SSO) establishment between Service-Provider(SP) and Identity-Provider(IDP)

Operations

Assertion Consumer Service for SAMLResponse from IDP

Request

ACS handles authenticates SAMLResponse (validates authentication & assertions) and redirects in response.

curl -i -X POST \
  https://docs.transportial.com/_mock/apis/saml/assertion \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
Response
application/json
{ "success": true, "message": "string", "code": 0 }

Update SAML

Request

Update SAML Configuration

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
noncestring

Nonce, a field that is not saved and returns exactly the same value you sent. This ensures you can identify your object that has been updated or created.

namestring
descriptionstring
allowedDomainsArray of stringsunique
idpSAMLMetadataobject(IDPSAMLMetadata)
spSAMLMetadataobject(SPSAMLMetadata)
enabledboolean
curl -i -X PUT \
  https://docs.transportial.com/_mock/apis/saml \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "nonce": "string",
    "name": "string",
    "description": "string",
    "allowedDomains": [
      "string"
    ],
    "idpSAMLMetadata": {
      "type": "SPSAMLMetadata",
      "entityID": "string",
      "signingCertificates": [
        {
          "certificateId": "string",
          "base64EncodedString": "string",
          "issuer": "string",
          "subject": "string",
          "isValid": true,
          "validFrom": "2019-08-24T14:15:22Z",
          "validTo": "2019-08-24T14:15:22Z",
          "validationError": "string"
        }
      ],
      "ssoServices": [
        {
          "binding": "string",
          "location": "string"
        }
      ],
      "protocol": "string",
      "xmlDigitalSignature": "string",
      "nameIDPolicyFormat": "string",
      "wantSignedAuthnRequests": true
    },
    "spSAMLMetadata": {
      "type": "SPSAMLMetadata",
      "entityID": "string",
      "signingCertificates": [
        {
          "certificateId": "string",
          "base64EncodedString": "string",
          "issuer": "string",
          "subject": "string",
          "isValid": true,
          "validFrom": "2019-08-24T14:15:22Z",
          "validTo": "2019-08-24T14:15:22Z",
          "validationError": "string"
        }
      ],
      "ssoServices": [
        {
          "binding": "string",
          "location": "string"
        }
      ],
      "protocol": "string",
      "xmlDigitalSignature": "string",
      "nameIDPolicyFormat": "string",
      "isAuthenRequestSigned": true,
      "wantAssertionsSigned": true
    },
    "enabled": true
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
samlobject(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "saml": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "description": "string", "allowedDomains": [], "idpSAMLMetadata": {}, "spSAMLMetadata": {}, "enabled": true } }

Add new SAML

Request

Add new SAML Configuration

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
noncestring

Nonce, a field that is not saved and returns exactly the same value you sent. This ensures you can identify your object that has been updated or created.

namestring
descriptionstring
allowedDomainsArray of stringsunique
idpSAMLMetadataobject(IDPSAMLMetadata)
spSAMLMetadataobject(SPSAMLMetadata)
enabledboolean
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/saml \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "nonce": "string",
    "name": "string",
    "description": "string",
    "allowedDomains": [
      "string"
    ],
    "idpSAMLMetadata": {
      "type": "SPSAMLMetadata",
      "entityID": "string",
      "signingCertificates": [
        {
          "certificateId": "string",
          "base64EncodedString": "string",
          "issuer": "string",
          "subject": "string",
          "isValid": true,
          "validFrom": "2019-08-24T14:15:22Z",
          "validTo": "2019-08-24T14:15:22Z",
          "validationError": "string"
        }
      ],
      "ssoServices": [
        {
          "binding": "string",
          "location": "string"
        }
      ],
      "protocol": "string",
      "xmlDigitalSignature": "string",
      "nameIDPolicyFormat": "string",
      "wantSignedAuthnRequests": true
    },
    "spSAMLMetadata": {
      "type": "SPSAMLMetadata",
      "entityID": "string",
      "signingCertificates": [
        {
          "certificateId": "string",
          "base64EncodedString": "string",
          "issuer": "string",
          "subject": "string",
          "isValid": true,
          "validFrom": "2019-08-24T14:15:22Z",
          "validTo": "2019-08-24T14:15:22Z",
          "validationError": "string"
        }
      ],
      "ssoServices": [
        {
          "binding": "string",
          "location": "string"
        }
      ],
      "protocol": "string",
      "xmlDigitalSignature": "string",
      "nameIDPolicyFormat": "string",
      "isAuthenRequestSigned": true,
      "wantAssertionsSigned": true
    },
    "enabled": true
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
samlobject(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "saml": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "description": "string", "allowedDomains": [], "idpSAMLMetadata": {}, "spSAMLMetadata": {}, "enabled": true } }

Get SAML

Request

Get a SAML Configuration by id

Path
idstringrequired
Headers
Authorizationstringrequired
curl -i -X GET \
  'https://docs.transportial.com/_mock/apis/saml/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
samlobject(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "saml": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "description": "string", "allowedDomains": [], "idpSAMLMetadata": {}, "spSAMLMetadata": {}, "enabled": true } }

Delete SAML

Request

Delete a SAML Configuration

Path
idstringrequired
Headers
Authorizationstringrequired
curl -i -X DELETE \
  'https://docs.transportial.com/_mock/apis/saml/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
samlobject(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "saml": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "description": "string", "allowedDomains": [], "idpSAMLMetadata": {}, "spSAMLMetadata": {}, "enabled": true } }

Generate Service-Provider's SAML Metadata XML File

Request

Generate XML File based on provided Service-Provider's SAML Metadata.

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
typestring
Enum"SPSAMLMetadata""IDPSAMLMetadata"
entityIDstring
signingCertificatesArray of objects(CertificateInfo)
ssoServicesArray of objects(SSOService)
protocolstring
xmlDigitalSignaturestring
nameIDPolicyFormatstring
isAuthenRequestSignedboolean
wantAssertionsSignedboolean
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/saml/spSamlMetadata/xml \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "SPSAMLMetadata",
    "entityID": "string",
    "signingCertificates": [
      {
        "certificateId": "string",
        "base64EncodedString": "string",
        "issuer": "string",
        "subject": "string",
        "isValid": true,
        "validFrom": "2019-08-24T14:15:22Z",
        "validTo": "2019-08-24T14:15:22Z",
        "validationError": "string"
      }
    ],
    "ssoServices": [
      {
        "binding": "string",
        "location": "string"
      }
    ],
    "protocol": "string",
    "xmlDigitalSignature": "string",
    "nameIDPolicyFormat": "string",
    "isAuthenRequestSigned": true,
    "wantAssertionsSigned": true
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
spSAMLMetadataXMLStringstring
Response
application/json
{ "success": true, "message": "string", "code": 0, "spSAMLMetadataXMLString": "string" }

Get Platform SAML Metadata

Request

Get current platform's SAML Metadata (Issuer, Assertion Consumer Service URL, etc.) required for a SAML Configuration.

Headers
Authorizationstringrequired
curl -i -X GET \
  https://docs.transportial.com/_mock/apis/saml/platformSamlMetadata \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
spSAMLMetadataobject(SPSAMLMetadata)
Response
application/json
{ "success": true, "message": "string", "code": 0, "spSAMLMetadata": { "type": "SPSAMLMetadata", "entityID": "string", "signingCertificates": [], "ssoServices": [], "protocol": "string", "xmlDigitalSignature": "string", "nameIDPolicyFormat": "string", "isAuthenRequestSigned": true, "wantAssertionsSigned": true } }

Get SAMLs

Request

Get SAML Configurations

Path
offsetinteger(int64)required
amountstringrequired
Headers
Authorizationstringrequired
curl -i -X GET \
  'https://docs.transportial.com/_mock/apis/samls/{offset}/{amount}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
totalResultsinteger(int32)
samlsArray of objects(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "totalResults": 0, "samls": [ {} ] }

Get SAMLs

Request

Get SAML Configurations

Path
offsetinteger(int64)required
amountinteger(int64)required
Headers
Authorizationstringrequired
curl -i -X POST \
  'https://docs.transportial.com/_mock/apis/samls/{offset}/{amount}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
totalResultsinteger(int32)
samlsArray of objects(SAML)
Response
application/json
{ "success": true, "message": "string", "code": 0, "totalResults": 0, "samls": [ {} ] }

Pricing

A pricing models the path going from one location to at least one other location.

Operations

Route

A route models the path going from one location to at least one other location.

Operations

Routing

Everything routing: meaning the routes from A-B supporting multiple modalities

Operations

ScheduleRoute

A scheduleRoute is a device that is able to measure a quantity in a certain unit, such as measuring the speed in km/h.

Operations

Sensor

A sensor is a device that is able to measure a quantity in a certain unit, such as measuring the speed in km/h.

Operations

Support

Support tickets are there to diagnose issues in the software or help users if they have a question

Operations

Tachograph

Tachograph methods

Operations

Team

A Team is a group of Vehicle's. Groups can be used to reference a list of vehicles without having to select each individual one.

Operations

Tender

Tenders can be stacked and constrain different activities in their context

Operations

Terminal

Terminals

Operations

ToDoComment

Object describing a geographic toDoComment. A toDoComment can either be a point or an area.

Operations

TQL

TQL stands for "Transportial Query Language". It's used to be able to run any query from a given JSON request

Operations

TransportOrder

The TransportOrder is the top-level entity to model a group of related consignments that might be transported separately, but need to be administered together.

Operations

Trip

A Trip is an aggregate entity that combines various entities to model visiting various locations, potentially doing one or multiple actions on each location, such as loading or unloading consignments. It is optionally coupled to a Vehicle that is/was driving this trip.

Operations

Type

Types

Operations

User

Users related to the platform and all actions required

Operations

User roles

The permissions grouped by a "Role", that can be assigned to a user

Operations

Settings

The user settings for the system

Operations

BoardComputer

A Boardcomputer is a device that tracks properties of a Vehicle. Values received from a BoardComputer can be the current location, speed, temperatues etc.

Operations

Vehicle

A Vehicle is a means to transport consignments from one location to potentially multiple other locations. There are various types of vehicles, each with their own unique properties like size, dimensions, fuel type and means of transport (by air, on land, over sea).

Operations

VehicleGroup

A VehicleGroup is a group of Vehicle's. Groups can be used to reference a list of vehicles without having to select each individual one.

Operations

Widget

Widgets can be stacked and constrain different activities in their context

Operations