POST api/asset/UpdateAsset?ApplicationKey={ApplicationKey}&APIKey={APIKey}&DeviceID={DeviceID}
This method allow you to modify detail information of registered asset in Traxia service.
Request Information
URI Parameters
| Name | Description | Type | Additional Information |
|---|---|---|---|
| ApplicationKey |
The application identity issued by an authorized publisher of Traxia services. This identity is unique and generated one-time during registration. |
string |
Required |
| APIKey |
Secret key issued to be challenged as identity verification. |
string |
Required |
| DeviceID |
Unique code to identify a device that connects to the Traxia system, such as IMEI. |
string |
None |
Body Parameters
Submit the asset object information to be updated.
Asset| Name | Description | Type | Additional Information |
|---|---|---|---|
| AssetCode |
A Primary Name Code to identify an asset, usually it consist of Vehicle License Plate Number, Unit Serial Number, Machine Number, or other Asset Name which refer to an individual asset. |
string |
None |
| DeviceID |
Unique code to identify a device that connects to the Traxia system, such as IMEI. |
string |
None |
| AssetDescription |
A brief description to give detailed attributes and characteristics about the asset. |
string |
None |
| SIMCardNumber |
Unique code to identify a SIM card on the device that connects to the Traxia system. |
string |
None |
| GPSTimeStamp |
Information about the last time the GPS data was retrieved. |
date |
None |
| HBTimeStamp |
Information about the last time HB data was retrieved |
date |
None |
| Altitude |
Position of asset that measure by height above the ground or above the sea level. |
integer |
None |
| Heading |
Compass direction in which the asset is directed or pointed, it consists of value from 0 to 360. |
integer |
None |
| Ignition |
Indicates asset ignition status whether the engine is active or not. |
boolean |
None |
| Latitude |
Geographic coordinate that specifies the north–south position of an asset on the Earth's surface. |
decimal number |
None |
| Longitude |
Geographic coordinate that specifies the east–west position of an asset on the Earth's surface. |
decimal number |
None |
| MarkingID |
Unique ID to identified geofence boundaries, it Indicates the status of an asset towards geofence boundaries. 0 indicates asset does not enter any geofence boundaries. |
integer |
None |
| MarkingName |
Geofence Boundaries name which defined by user. |
string |
None |
| ReportID |
Unique ID to identified device data report type. |
integer |
None |
| ReportName |
Name of device data report type. |
string |
None |
| Speed |
The velocity value of the asset as measured by the Traxia system with the unit of measurement used is km / hour. |
decimal number |
None |
| Address |
The address of asset was located. |
string |
None |
| AssetModel |
The brand and model of the asset. |
string |
None |
| AssetYear |
The year in which the asset was created or produced. |
integer |
None |
| OperatorID |
Unique ID to identify driver or operator is using, driving, operating the asset. |
integer |
None |
| OperatorName |
Name of the driver or operator. |
string |
None |
| GMT |
Indicates asset’s current time zone. |
integer |
None |
| CountryCode |
Unique code to identify at which country the asset was produced. |
string |
None |
| Odometer |
Instrument used for measuring the distance traveled by a vehicle. |
string |
None |
| EngineLoad |
The amount of air flowing through the engine as a percentage of the theoretical maximum. |
string |
None |
| EngineCoolantTemperature |
Indicates temperature of engine coolant which measured by ECT Sensor. |
string |
None |
| EngineRPM |
Provides Engine RPM information detected by OBDII interface and sensors. |
string |
None |
| VehicleSpeed |
Asset velocity which measured by OBDII sensors. |
string |
None |
| EngineRunTime |
Provides duration or time elapsed since Engine Started. |
string |
None |
| FuelLevel |
Provide percentage of remaining fuel capacity. |
string |
None |
| AmbientAirTemperature |
Indicates temperature value of surrounding ambient air detected by OBDII Interface. |
string |
None |
| FuelType |
Indicates Type of fuel which asset used. |
string |
None |
| HybridBatteryPackRemainingLife |
Indicates percentage of remaining battery capacity for Hybrid Vehicle which detected by OBDII Interface. |
string |
None |
| EngineOilTemperature |
Provide temperature information of Engine Oil detected by OBDII interface. |
string |
None |
| EngineCoolantTemperature1 |
Indicates temperature of engine coolant which measured by ECT Sensor. |
string |
None |
| EngineCoolantTemperature2 |
Indicates temperature of engine coolant which measured by ECT Sensor. |
string |
None |
| HybridEvVehicleSystemData |
Provide on-board data acquisition system of hybrid electric vehicle. |
string |
None |
| VehicleIdentificationNumber |
Provide information as the car's fingerprint detected by OBDII data information, as no two vehicles in operation have the same VIN. |
string |
None |
| TimeZone | string |
None |
|
| Temperature | decimal number |
None |
|
| Humidity | integer |
None |
|
| SubscriberID | integer |
None |
|
| GUID | string |
None |
|
| CreatedBy |
The person who responded to register the data (filled in only when registering). |
string |
None |
| CreatedTimeStamp |
The time when a data record was created. |
date |
None |
| LastUpdateBy |
The last person who modified the data (filled only when updating). |
string |
None |
| LastUpdateTimeStamp |
The time when a data record was modified (filled only when updating). |
date |
None |
| Discard |
Status of enabling or disabling data visibility to the system. (filled in only when disabling or enabling). |
boolean |
None |
| DiscardBy |
The last person who discarded the data. (filled in only when disabling). |
string |
None |
| DiscardTimeStamp |
Information about the time when the last discard data happened (filled in only when disabling). |
date |
None |
Request Formats
application/json, text/json
// parameter to update the asset
{
"AssetCode": "CDR-9774", // mandatory, your asset code, string
"TraxiaID": "357601090009774",// mandatory, your Traxia id, string
"AssetDescription": "Japan Device",// mandatory, can be skipped by entering space
"SubscriberID": 1, // mandatory, your subscriber id, integer
"SIMCardNumber": "0",// mandatory, can be skipped by entering a zero value
"CreatedBy": care@dit.co.id // mandatory, email from the responsible person, string
}
application/xml, text/xml
<Asset xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Traxia.Credential.Assets"> <CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 42</CreatedBy> <CreatedTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</CreatedTimeStamp> <Discard xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">true</Discard> <DiscardBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 45</DiscardBy> <DiscardTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</DiscardTimeStamp> <GUID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 41</GUID> <LastUpdateBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 43</LastUpdateBy> <LastUpdateTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</LastUpdateTimeStamp> <SubscriberID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">40</SubscriberID> <Address>sample string 15</Address> <Altitude>5</Altitude> <AmbientAirTemperature>sample string 29</AmbientAirTemperature> <AssetCode>sample string 1</AssetCode> <AssetDescription>sample string 3</AssetDescription> <AssetModel>sample string 16</AssetModel> <AssetYear>17</AssetYear> <CountryCode>sample string 21</CountryCode> <DeviceID>sample string 2</DeviceID> <EngineCoolantTemperature>sample string 24</EngineCoolantTemperature> <EngineCoolantTemperature1>sample string 33</EngineCoolantTemperature1> <EngineCoolantTemperature2>sample string 34</EngineCoolantTemperature2> <EngineLoad>sample string 23</EngineLoad> <EngineOilTemperature>sample string 32</EngineOilTemperature> <EngineRPM>sample string 25</EngineRPM> <EngineRunTime>sample string 27</EngineRunTime> <FuelLevel>sample string 28</FuelLevel> <FuelType>sample string 30</FuelType> <GMT>20</GMT> <GPSTimeStamp>2024-12-18T15:49:47.3117505+07:00</GPSTimeStamp> <HBTimeStamp>2024-12-18T15:49:47.3117505+07:00</HBTimeStamp> <Heading>6</Heading> <Humidity>39</Humidity> <HybridBatteryPackRemainingLife>sample string 31</HybridBatteryPackRemainingLife> <HybridEvVehicleSystemData>sample string 35</HybridEvVehicleSystemData> <Ignition>true</Ignition> <Latitude>8.1</Latitude> <Longitude>9.1</Longitude> <MarkingID>10</MarkingID> <MarkingName>sample string 11</MarkingName> <Odometer>sample string 22</Odometer> <OperatorID>18</OperatorID> <OperatorName>sample string 19</OperatorName> <ReportID>12</ReportID> <ReportName>sample string 13</ReportName> <SIMCardNumber>sample string 4</SIMCardNumber> <Speed>14.1</Speed> <Temperature>38.1</Temperature> <TimeZone>sample string 37</TimeZone> <VehicleIdentificationNumber>sample string 36</VehicleIdentificationNumber> <VehicleSpeed>sample string 26</VehicleSpeed> </Asset>
multipart/form-data
<Asset xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Traxia.Credential.Assets"><CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 42</CreatedBy><CreatedTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</CreatedTimeStamp><Discard xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">true</Discard><DiscardBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 45</DiscardBy><DiscardTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</DiscardTimeStamp><GUID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 41</GUID><LastUpdateBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 43</LastUpdateBy><LastUpdateTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:49:47.3117505+07:00</LastUpdateTimeStamp><SubscriberID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">40</SubscriberID><Address>sample string 15</Address><Altitude>5</Altitude><AmbientAirTemperature>sample string 29</AmbientAirTemperature><AssetCode>sample string 1</AssetCode><AssetDescription>sample string 3</AssetDescription><AssetModel>sample string 16</AssetModel><AssetYear>17</AssetYear><CountryCode>sample string 21</CountryCode><DeviceID>sample string 2</DeviceID><EngineCoolantTemperature>sample string 24</EngineCoolantTemperature><EngineCoolantTemperature1>sample string 33</EngineCoolantTemperature1><EngineCoolantTemperature2>sample string 34</EngineCoolantTemperature2><EngineLoad>sample string 23</EngineLoad><EngineOilTemperature>sample string 32</EngineOilTemperature><EngineRPM>sample string 25</EngineRPM><EngineRunTime>sample string 27</EngineRunTime><FuelLevel>sample string 28</FuelLevel><FuelType>sample string 30</FuelType><GMT>20</GMT><GPSTimeStamp>2024-12-18T15:49:47.3117505+07:00</GPSTimeStamp><HBTimeStamp>2024-12-18T15:49:47.3117505+07:00</HBTimeStamp><Heading>6</Heading><Humidity>39</Humidity><HybridBatteryPackRemainingLife>sample string 31</HybridBatteryPackRemainingLife><HybridEvVehicleSystemData>sample string 35</HybridEvVehicleSystemData><Ignition>true</Ignition><Latitude>8.1</Latitude><Longitude>9.1</Longitude><MarkingID>10</MarkingID><MarkingName>sample string 11</MarkingName><Odometer>sample string 22</Odometer><OperatorID>18</OperatorID><OperatorName>sample string 19</OperatorName><ReportID>12</ReportID><ReportName>sample string 13</ReportName><SIMCardNumber>sample string 4</SIMCardNumber><Speed>14.1</Speed><Temperature>38.1</Temperature><TimeZone>sample string 37</TimeZone><VehicleIdentificationNumber>sample string 36</VehicleIdentificationNumber><VehicleSpeed>sample string 26</VehicleSpeed></Asset>
application/x-www-form-urlencoded
Sample not available.
Response Information
Resource Description
BaseResponse| Name | Description | Type | Additional Information |
|---|---|---|---|
| Acknowledge |
Acknowledgement of API request format, whether you are submitting the requested parameter in a proper format. |
Acknowledge |
None |
| ResponseCode |
Indicates the result of your API service process. Negative results may have different code indicators depending on their failure type. |
ResponseCode |
None |
| ResponseMessage |
Negative API process results may have additional information in text to explain the failure reasons. |
string |
None |
| Data |
Data provide a universal object response model transformed into JSON compatible format. You will need to recognize the type of returned object model of each of your request. For more information about object class model, please consult our object class library documentation. |
Object |
None |
| Latency | integer |
None |
Response Formats
application/json, text/json
// Succesful result of update asset
{
"Acknowledge": 1,
"ResponseCode": 200,
"ResponseMessage": "Request was succesfully performed.",
"Data": "B1967SMB"
}