oTMS-openapi en
  1. oTMS API
oTMS-openapi en
  • oTMS API
    • Order Import
      PUT
    • orderOutbound
      POST
    • shipPointImport
      PUT
    • Delete delivery point
      DELETE
    • Order Assignment to Driver
      POST
    • TruckAndDriverImport
      PUT
    • Assign Driver to Order
      POST
    • Job Sheet Import
      PUT
    • Delete Job Sheet
      PUT
    • Order Recall
      POST
    • Share Link
      PUT
    • Carrier Export
      POST
    • Order Update
      PUT
    • Order Dispatch
      POST
    • Order Revoke
      PUT
    • Order Rating
      POST
    • Order Handover Creation
      PUT
    • Oorder Custom Update
      POST
    • Price File Matching
      POST
    • Order cost update
      POST
    • Shipper/Receiver export
      POST
    • Job Sheet Outbound
      POST
    • Job Sheet Recall
      PUT
    • TruckPosition
      POST
    • GPS Device
      POST
    • Jobsheet To Driver
      PUT
    • TrackandTrace
      POST
    • H5 Link
      PUT
  1. oTMS API

TruckPosition

Developing
POST
/ws/openapi/1.0/truck/positions

Get Latest Vehicle Location by License Plate#

Through this interface, you can obtain the latest location information for your company's vehicles using their license plate numbers.

Configuration Instructions#

oTMS provides Web Service interfaces in both production and testing environments, where the testing environment is primarily used for integration testing. In both environments, API account credentials must be assigned by the oTMS system administrator before they can be used.

Important Notes#

Please use the public interfaces reasonably. If abnormal calls or any issues affecting system performance are detected, we will impose restrictions on the API account calls, or even deactivate them.

Call Limitations#

Currently, the call limit for this interface is set to a maximum of 20 requests per second per company.

Request

Header Params
login
string 
optional
Example:
login
password
string 
optional
Example:
password
Body Params application/json
trucks
array [object {3}] 
optional
truckPlate
string 
optional
Equipment No
from
string 
optional
Starting time of trajectory query，yyyy-mm-ddThh:mm:ss
to
string 
optional
End time of trajectory query,yyyy-mm-ddThh:mm:ss
Example
{
    "trucks": [
        {
            "truckPlate": "AA082503",
            "from": "2024-11-26T09:00:00",
            "to": "2024-11-28T15:40:00"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://login.otms.com/ws/openapi/1.0/truck/positions' \
--header 'login: login' \
--header 'password: password' \
--header 'Content-Type: application/json' \
--data-raw '{
    "trucks": [
        {
            "truckPlate": "AA082503",
            "from": "2024-11-26T09:00:00",
            "to": "2024-11-28T15:40:00"
        }
    ]
}'

Responses

🟢200成功
application/json
Body
code
string 
optional
msg
string 
optional
data
object 
optional
latitude
string 
optional
longitude
string 
optional
truckPlate
string 
optional
tempList
string 
optional
date
string 
optional
Example
{
    "code": "0",
    "msg": "success",
    "data": [
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T09:37:43.028+0000"
        },
        {
            "latitude": 31.21922755,
            "longitude": 121.52860196,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T09:56:01.060+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T09:58:06.267+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T09:58:19.071+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:03:35.526+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:03:35.601+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:08:09.983+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:08:10.042+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:12:35.564+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:13:10.013+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:17:35.633+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:18:10.023+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:21:35.665+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:22:14.448+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:26:35.699+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:27:14.485+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:30:35.741+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:31:18.614+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:35:35.742+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:36:18.655+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:40:20.032+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.52864887,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:40:32.982+0000"
        },
        {
            "latitude": 31.219171,
            "longitude": 121.528651,
            "truckPlate": "AA082503",
            "tempList": [],
            "date": "2024-11-26T10:45:20.052+0000"
        },
        {
            "latitude": 31.2191762,
            "longitude": 121.528648
Modified at 2025-06-06 02:46:48
Previous
Job Sheet Recall
Next
GPS Device
Built with