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

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

Block user

Request

Block a user from the platform

Path
idstringrequired
Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
curl -i -X POST \
  'https://docs.transportial.com/_mock/apis/user/block/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Get the logged in user

Request

Get the currently logged in user

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

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Update the user

Request

Update the password of the currently logged in user. The current password has to be known for this change

Bodyapplication/jsonrequired
usernamestring
emailstring
roleobject(UserRole)
curl -i -X PUT \
  https://docs.transportial.com/_mock/apis/user \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "string",
    "email": "string",
    "role": {
      "nonce": "string",
      "name": "string",
      "level": 0
    }
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Create a new user

Request

Invite a new user to the platform through an invitation e-mail, the user has to reset his password.

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
usernamestring
emailstring
roleobject(UserRole)
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "string",
    "email": "string",
    "role": {
      "nonce": "string",
      "name": "string",
      "level": 0
    }
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Get the user by id

Request

Get a user by the given ID

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

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Unblock a user

Request

Unblock a user from the platform

Path
idstringrequired
Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
curl -i -X DELETE \
  'https://docs.transportial.com/_mock/apis/user/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Add FCM device

Request

Add a device FCM token for a user. This enables notification sending

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
tokenstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/fcm \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userFCMobject(UserFCM)
Response
application/json
{ "success": true, "message": "string", "code": 0, "userFCM": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "token": "string", "endsAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z" } }

Start of recovering password

Request

The start of recovering

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
emailstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/forgot \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "string"
  }'

Responses

Success

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

Get if the e-mail exists yes or no

Request

Check if an e-mail is already in use for another user

Path
emailstringrequired
curl -i -X POST \
  'https://docs.transportial.com/_mock/apis/user/email/exists/{email}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

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

Get a user active session by login token

Request

Get a user active session by active 'login attempt session''s token. Note: 'login attempt session' is a session for any specific login attemptSuch sessions would usually have short time window, hence endpoint usable only in that short duration.

Query
tokenstringrequired
curl -i -X GET \
  'https://docs.transportial.com/_mock/apis/user/session?token=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
sessionobject(SessionModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "session": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "refresh_token": "string", "ip": "string", "device": "string", "startedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "passedTwoFactorAuthentication": true, "access_token": "string" } }

Get a user active session

Request

Get the currently active sessions for a user

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

Responses

Success

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

Get the login method

Request

Get the login method to be used for this users authentication

Bodyapplication/jsonrequired
usernamestring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/login-method \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
loginMethodstring
Enum"DEFAULT""SAML"
redirectURLstring
platformobject(Platform)
Response
application/json
{ "success": true, "message": "string", "code": 0, "loginMethod": "DEFAULT", "redirectURL": "string", "platform": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "name": "string", "nameSpace": "string", "logo": {}, "favicon": {}, "notificationLogo": {}, "fullLogo": {}, "backgroundImage": {}, "darkLogo": {}, "darkFavicon": {}, "darkNotificationLogo": {}, "darkFullLogo": {}, "darkBackgroundImage": {}, "primaryColor": "string", "secondaryColor": "string", "darkPrimaryColor": "string", "darkSecondaryColor": "string", "hostNames": [], "features": [], "planningSettings": {}, "pricingSettings": {}, "credentialSettings": {}, "routingSettings": {}, "translationSettings": {}, "uiSettings": {}, "canRegister": true, "canRequestAccess": true, "description": "string", "contactEmail": "string", "apps": [], "disablingAt": "2019-08-24T14:15:22Z", "disabled": true, "inWaitList": true } }

Get if the username exists yes or no

Request

Check if the given username is already in use for another user

Path
usernamestringrequired
curl -i -X POST \
  'https://docs.transportial.com/_mock/apis/user/username/exists/{username}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

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

Get all the users

Request

Get all users

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

Responses

Success

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

Search users by search parameters

Request

Search users by search parameters and

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

Responses

Success

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

Invite a new user to the platform

Request

Invite a new user to the platform through an invitation e-mail, the user has to reset his password.

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
firstNamestring
lastNamestring
usernamestring
emailstring
roleobject(UserRole)
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/invite \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "string",
    "lastName": "string",
    "username": "string",
    "email": "string",
    "role": {
      "nonce": "string",
      "name": "string",
      "level": 0
    }
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

User login otp

Request

Authenticate a user with the OTP

Bodyapplication/jsonrequired
tokenstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/login:otp \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
sessionobject(SessionModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "session": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "refresh_token": "string", "ip": "string", "device": "string", "startedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "passedTwoFactorAuthentication": true, "access_token": "string" } }

User login

Request

Authenticate a user by logging in

Bodyapplication/jsonrequired
usernamestring
passwordstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/login \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "string",
    "password": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
sessionobject(SessionModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "session": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "refresh_token": "string", "ip": "string", "device": "string", "startedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "passedTwoFactorAuthentication": true, "access_token": "string" } }

Log all user session out

Request

End the all the sessions of the logged in user. Meaning over all devices the sessions are invalidated

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

Responses

Success

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

Log user out

Request

End the current session of the logged in user

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

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
sessionobject(SessionModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "session": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "refresh_token": "string", "ip": "string", "device": "string", "startedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "passedTwoFactorAuthentication": true, "access_token": "string" } }

Recover user login details

Request

Authenticate a user by logging in

Bodyapplication/jsonrequired
idstring
tokenstring
passwordstring
repeatPasswordstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/recover \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "string",
    "token": "string",
    "password": "string",
    "repeatPassword": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Register user

Request

Register a new user

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
typestring
Enum"user""developer""chauffeur"
accountTypestring
Enum"default""customer""supplier""planning""financial"
firstNamestring
lastNamestring
usernamestring
emailstring
passwordstring
repeatPasswordstring
recaptchastring
newsletterboolean
termsAndConditionsboolean
billingIdstring
businessobject(Business)
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/register \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "user",
    "accountType": "default",
    "firstName": "string",
    "lastName": "string",
    "username": "string",
    "email": "string",
    "password": "string",
    "repeatPassword": "string",
    "recaptcha": "string",
    "newsletter": true,
    "termsAndConditions": true,
    "billingId": "string",
    "business": {
      "id": "string",
      "nonce": "string",
      "uuid": "string",
      "primaryPlatformId": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "relationType": "string",
      "alias": "string",
      "description": "string",
      "transportLicenseNumber": "string",
      "eori": "string",
      "scacCode": "string",
      "industry": {
        "id": "string",
        "nonce": "string",
        "uuid": "string",
        "primaryPlatformId": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "abbreviated": "string",
        "enabled": true
      },
      "website": "string",
      "coc": "string",
      "vat": "string",
      "verified": true,
      "documents": [
        {
          "associationType": "inline",
          "entity": {
            "nonce": "string",
            "description": "string",
            "expiresAt": "2019-08-24T14:15:22Z",
            "fileName": "string",
            "mimeType": "string",
            "encoding": "string",
            "verified": true,
            "content": {
              "contentType": "data",
              "data": "string"
            },
            "file": {
              "nonce": "string",
              "url": "string",
              "path": "string",
              "name": "string",
              "originalName": "string",
              "size": 0,
              "purpose": "string",
              "type": "IMAGE",
              "mimeType": "string",
              "extension": "string",
              "uploadedAt": "2019-08-24T14:15:22Z"
            },
            "externalAttributes": {
              "property1": {},
              "property2": {}
            },
            "name": "string"
          }
        }
      ],
      "logo": {
        "nonce": "string",
        "url": "string",
        "path": "string",
        "name": "string",
        "originalName": "string",
        "size": 0,
        "purpose": "string",
        "type": "IMAGE",
        "mimeType": "string",
        "extension": "string",
        "uploadedAt": "2019-08-24T14:15:22Z"
      },
      "banners": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "url": "string",
          "path": "string",
          "name": "string",
          "originalName": "string",
          "size": 0,
          "purpose": "string",
          "type": "IMAGE",
          "mimeType": "string",
          "extension": "string",
          "uploadedAt": "2019-08-24T14:15:22Z"
        }
      ],
      "locations": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "type": "warehouse",
          "name": "string",
          "unCode": "string",
          "geoReference": {
            "id": "string",
            "nonce": "string",
            "uuid": "string",
            "primaryPlatformId": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "updatedAt": "2019-08-24T14:15:22Z",
            "type": "addressGeoReference",
            "name": "string",
            "street": "string",
            "houseNumber": "string",
            "houseNumberAddition": "string",
            "postalCode": "string",
            "city": "string",
            "country": "string",
            "hash": "string"
          },
          "administrativeReference": {
            "name": "string",
            "street": "string",
            "houseNumber": "string",
            "houseNumberAddition": "string",
            "postalCode": "string",
            "city": "string",
            "country": "string"
          },
          "contactDetails": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "type": "iban",
              "value": "string",
              "remarks": "string"
            }
          ],
          "constraints": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "type": "accessConstraint",
              "name": "string",
              "enforceability": "enforced",
              "description": "string"
            }
          ],
          "pricingElements": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "name": "string",
              "description": "string",
              "category": {
                "id": "string",
                "nonce": "string",
                "uuid": "string",
                "primaryPlatformId": "string",
                "createdAt": "2019-08-24T14:15:22Z",
                "updatedAt": "2019-08-24T14:15:22Z",
                "name": "string",
                "creditCode": "string",
                "debitCode": "string",
                "defaultValue": 0.1,
                "enabled": true
              },
              "amount": {
                "id": "string",
                "nonce": "string",
                "uuid": "string",
                "primaryPlatformId": "string",
                "createdAt": "2019-08-24T14:15:22Z",
                "updatedAt": "2019-08-24T14:15:22Z",
                "amount": 0.1,
                "currency": {},
                "taxRate": {
                  "identifiers": []
                },
                "inclusiveOfTax": true
              }
            }
          ],
          "remark": "string",
          "hash": "string",
          "externalAttributes": {
            "property1": {},
            "property2": {}
          }
        }
      ],
      "identification": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "url": "string",
          "path": "string",
          "name": "string",
          "originalName": "string",
          "size": 0,
          "purpose": "string",
          "type": "IMAGE",
          "mimeType": "string",
          "extension": "string",
          "uploadedAt": "2019-08-24T14:15:22Z"
        }
      ],
      "contactDetails": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "type": "iban",
          "value": "string",
          "remarks": "string"
        }
      ],
      "contactPersons": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "firstName": "string",
          "lastName": "string",
          "position": "string",
          "email": "string",
          "phone": "string"
        }
      ],
      "administration": {
        "id": "string",
        "nonce": "string",
        "uuid": "string",
        "primaryPlatformId": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "primary": true,
        "business": {},
        "currency": {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "name": "string",
          "short": "string",
          "sign": "string",
          "decimalDelimiter": "string",
          "thousandDelimiter": "string",
          "enabled": true
        },
        "balance": {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "amount": 0.1,
          "currency": {
            "id": "string",
            "nonce": "string",
            "uuid": "string",
            "primaryPlatformId": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "updatedAt": "2019-08-24T14:15:22Z",
            "name": "string",
            "short": "string",
            "sign": "string",
            "decimalDelimiter": "string",
            "thousandDelimiter": "string",
            "enabled": true
          },
          "taxRate": {
            "nonce": "string",
            "creditCode": "string",
            "debitCode": "string",
            "identifiers": [
              {
                "nonce": "string",
                "name": "string",
                "system": "string",
                "value": "string",
                "expiredAt": "2019-08-24T14:15:22Z"
              }
            ],
            "name": "string",
            "description": "string",
            "jurisdiction": "string",
            "percentage": 0.1,
            "inclusive": true,
            "active": true
          },
          "inclusiveOfTax": true
        },
        "numberFormat": "string",
        "numberLength": 0,
        "dueDays": 0,
        "invoiceNumberIndex": {
          "property1": 0,
          "property2": 0
        },
        "quoteNumberIndex": {
          "property1": 0,
          "property2": 0
        },
        "automaticallySendReminders": true,
        "invoiceTermsAndConditions": "string",
        "quoteTermsAndConditions": "string",
        "invoiceNumbering": 0,
        "quoteNumbering": 0
      },
      "pricingConfigurationCount": 0,
      "hasAgreedToPrice": true
    }
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userFCMobject(UserFCM)
Response
application/json
{ "success": true, "message": "string", "code": 0, "userFCM": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "token": "string", "endsAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z" } }

Request register user

Request

Register a new user

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
typestring
Enum"user""developer""chauffeur"
accountTypestring
Enum"default""customer""supplier""planning""financial"
firstNamestring
lastNamestring
usernamestring
emailstring
passwordstring
repeatPasswordstring
recaptchastring
newsletterboolean
termsAndConditionsboolean
billingIdstring
businessobject(Business)
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/register/request \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "user",
    "accountType": "default",
    "firstName": "string",
    "lastName": "string",
    "username": "string",
    "email": "string",
    "password": "string",
    "repeatPassword": "string",
    "recaptcha": "string",
    "newsletter": true,
    "termsAndConditions": true,
    "billingId": "string",
    "business": {
      "id": "string",
      "nonce": "string",
      "uuid": "string",
      "primaryPlatformId": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "relationType": "string",
      "alias": "string",
      "description": "string",
      "transportLicenseNumber": "string",
      "eori": "string",
      "scacCode": "string",
      "industry": {
        "id": "string",
        "nonce": "string",
        "uuid": "string",
        "primaryPlatformId": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "abbreviated": "string",
        "enabled": true
      },
      "website": "string",
      "coc": "string",
      "vat": "string",
      "verified": true,
      "documents": [
        {
          "associationType": "inline",
          "entity": {
            "nonce": "string",
            "description": "string",
            "expiresAt": "2019-08-24T14:15:22Z",
            "fileName": "string",
            "mimeType": "string",
            "encoding": "string",
            "verified": true,
            "content": {
              "contentType": "data",
              "data": "string"
            },
            "file": {
              "nonce": "string",
              "url": "string",
              "path": "string",
              "name": "string",
              "originalName": "string",
              "size": 0,
              "purpose": "string",
              "type": "IMAGE",
              "mimeType": "string",
              "extension": "string",
              "uploadedAt": "2019-08-24T14:15:22Z"
            },
            "externalAttributes": {
              "property1": {},
              "property2": {}
            },
            "name": "string"
          }
        }
      ],
      "logo": {
        "nonce": "string",
        "url": "string",
        "path": "string",
        "name": "string",
        "originalName": "string",
        "size": 0,
        "purpose": "string",
        "type": "IMAGE",
        "mimeType": "string",
        "extension": "string",
        "uploadedAt": "2019-08-24T14:15:22Z"
      },
      "banners": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "url": "string",
          "path": "string",
          "name": "string",
          "originalName": "string",
          "size": 0,
          "purpose": "string",
          "type": "IMAGE",
          "mimeType": "string",
          "extension": "string",
          "uploadedAt": "2019-08-24T14:15:22Z"
        }
      ],
      "locations": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "type": "warehouse",
          "name": "string",
          "unCode": "string",
          "geoReference": {
            "id": "string",
            "nonce": "string",
            "uuid": "string",
            "primaryPlatformId": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "updatedAt": "2019-08-24T14:15:22Z",
            "type": "addressGeoReference",
            "name": "string",
            "street": "string",
            "houseNumber": "string",
            "houseNumberAddition": "string",
            "postalCode": "string",
            "city": "string",
            "country": "string",
            "hash": "string"
          },
          "administrativeReference": {
            "name": "string",
            "street": "string",
            "houseNumber": "string",
            "houseNumberAddition": "string",
            "postalCode": "string",
            "city": "string",
            "country": "string"
          },
          "contactDetails": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "type": "iban",
              "value": "string",
              "remarks": "string"
            }
          ],
          "constraints": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "type": "accessConstraint",
              "name": "string",
              "enforceability": "enforced",
              "description": "string"
            }
          ],
          "pricingElements": [
            {
              "id": "string",
              "nonce": "string",
              "uuid": "string",
              "primaryPlatformId": "string",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "name": "string",
              "description": "string",
              "category": {
                "id": "string",
                "nonce": "string",
                "uuid": "string",
                "primaryPlatformId": "string",
                "createdAt": "2019-08-24T14:15:22Z",
                "updatedAt": "2019-08-24T14:15:22Z",
                "name": "string",
                "creditCode": "string",
                "debitCode": "string",
                "defaultValue": 0.1,
                "enabled": true
              },
              "amount": {
                "id": "string",
                "nonce": "string",
                "uuid": "string",
                "primaryPlatformId": "string",
                "createdAt": "2019-08-24T14:15:22Z",
                "updatedAt": "2019-08-24T14:15:22Z",
                "amount": 0.1,
                "currency": {},
                "taxRate": {
                  "identifiers": []
                },
                "inclusiveOfTax": true
              }
            }
          ],
          "remark": "string",
          "hash": "string",
          "externalAttributes": {
            "property1": {},
            "property2": {}
          }
        }
      ],
      "identification": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "url": "string",
          "path": "string",
          "name": "string",
          "originalName": "string",
          "size": 0,
          "purpose": "string",
          "type": "IMAGE",
          "mimeType": "string",
          "extension": "string",
          "uploadedAt": "2019-08-24T14:15:22Z"
        }
      ],
      "contactDetails": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "type": "iban",
          "value": "string",
          "remarks": "string"
        }
      ],
      "contactPersons": [
        {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "firstName": "string",
          "lastName": "string",
          "position": "string",
          "email": "string",
          "phone": "string"
        }
      ],
      "administration": {
        "id": "string",
        "nonce": "string",
        "uuid": "string",
        "primaryPlatformId": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "primary": true,
        "business": {},
        "currency": {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "name": "string",
          "short": "string",
          "sign": "string",
          "decimalDelimiter": "string",
          "thousandDelimiter": "string",
          "enabled": true
        },
        "balance": {
          "id": "string",
          "nonce": "string",
          "uuid": "string",
          "primaryPlatformId": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "amount": 0.1,
          "currency": {
            "id": "string",
            "nonce": "string",
            "uuid": "string",
            "primaryPlatformId": "string",
            "createdAt": "2019-08-24T14:15:22Z",
            "updatedAt": "2019-08-24T14:15:22Z",
            "name": "string",
            "short": "string",
            "sign": "string",
            "decimalDelimiter": "string",
            "thousandDelimiter": "string",
            "enabled": true
          },
          "taxRate": {
            "nonce": "string",
            "creditCode": "string",
            "debitCode": "string",
            "identifiers": [
              {
                "nonce": "string",
                "name": "string",
                "system": "string",
                "value": "string",
                "expiredAt": "2019-08-24T14:15:22Z"
              }
            ],
            "name": "string",
            "description": "string",
            "jurisdiction": "string",
            "percentage": 0.1,
            "inclusive": true,
            "active": true
          },
          "inclusiveOfTax": true
        },
        "numberFormat": "string",
        "numberLength": 0,
        "dueDays": 0,
        "invoiceNumberIndex": {
          "property1": 0,
          "property2": 0
        },
        "quoteNumberIndex": {
          "property1": 0,
          "property2": 0
        },
        "automaticallySendReminders": true,
        "invoiceTermsAndConditions": "string",
        "quoteTermsAndConditions": "string",
        "invoiceNumbering": 0,
        "quoteNumbering": 0
      },
      "pricingConfigurationCount": 0,
      "hasAgreedToPrice": true
    }
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userFCMobject(UserFCM)
Response
application/json
{ "success": true, "message": "string", "code": 0, "userFCM": { "id": "string", "nonce": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "user": {}, "token": "string", "endsAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z" } }

Unblock a user

Request

Unblock a user from the platform

Path
idstringrequired
Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
curl -i -X POST \
  'https://docs.transportial.com/_mock/apis/user/unblock/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Update logged in user password

Request

Update the password of the currently logged in user. The current password has to be known for this change

Bodyapplication/jsonrequired
oldPasswordstring
newPasswordstring
repeatPasswordstring
curl -i -X PUT \
  https://docs.transportial.com/_mock/apis/user/password \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "oldPassword": "string",
    "newPassword": "string",
    "repeatPassword": "string"
  }'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
userobject(UserModel)
Response
application/json
{ "success": true, "message": "string", "code": 0, "user": { "id": "string", "nonce": "string", "uuid": "string", "primaryPlatformId": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "type": "user", "username": "string", "avatar": {}, "firstName": "string", "lastName": "string", "email": "string", "phone": "string", "passwordModified": "2019-08-24T14:15:22Z", "twoFactorAuthentication": true, "status": "DELETED", "loginMethod": "DEFAULT", "timezone": "string", "vehicleGroups": [], "activeAdministration": {}, "accountType": "default", "standardLoadingSize": 0 } }

Setup a users 2FA

Request

Get the 2FA QR image and the recovery codes

Headers
Authorizationstringrequired
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/2fa/disable \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
qrstring
recoveryCodesArray of strings
Response
application/json
{ "success": true, "message": "string", "code": 0, "qr": "string", "recoveryCodes": [ "string" ] }

Recover 2FA

Request

Recover your account with a recovery code

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
recoveryCodestring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/2fa/recover \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "recoveryCode": "string"
  }'

Responses

Success

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

Setup a users 2FA

Request

Get the 2FA QR image and the recovery codes

Headers
Authorizationstringrequired
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/2fa/setup \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
qrstring
recoveryCodesArray of strings
Response
application/json
{ "success": true, "message": "string", "code": 0, "qr": "string", "recoveryCodes": [ "string" ] }

Verify 2FA code

Request

Verify an incoming 2FA code. In case of a first save this endpoint will also enable the 2FA

Headers
Authorizationstringrequired
Bodyapplication/jsonrequired
tokenstring
curl -i -X POST \
  https://docs.transportial.com/_mock/apis/user/2fa/verify \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "string"
  }'

Responses

Success

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

Verify e-mail address

Request

End the current session of the logged in user

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

Responses

Success

Bodyapplication/json
successboolean
messagestring
codeinteger(int32)
statusstring
Enum"DELETED""DEFAULT""CONFIRMED""REGISTERED"
Response
application/json
{ "success": true, "message": "string", "code": 0, "status": "DELETED" }

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