POST api/subscriber/UpdateSubscriber?ApplicationKey={ApplicationKey}&APIKey={APIKey}&DeviceID={DeviceID}

This method allow you to modify the detailed information of the registered subscriber.

Request Information

URI Parameters

NameDescriptionTypeAdditional 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 subscriber object information to be updated.

Subscriber
NameDescriptionTypeAdditional Information
SubscriberCode

Unique code as the initial of a new subscriber joining the Traxia system.

string

Required

SubscriberName

Name of the Traxia subcriber, either people who responsible of the project or project name.

string

Required

CompanyName

Company name that become Traxia subcriber.

string

Required

ContactPerson

The name of a person who will be the person in charge of the company to use the Traxia system.

string

Required

PhoneNumber

The contact number of the company to use the Traxia system.

string

Required

EmailAddress

The email address of the company to use the Traxia system.

string

Required

CountryCode

Country code that will be used as the marketing area for the device by the Traxia subscriber.

string

Required

GMT

GMT from the marketing area which will be used by the Traxia system to determine the timestamp for the formation of fleet management operation.

integer

Required

SubscriberToken

An Unique code generated from the system for that subscriber using the Traxia system.

string

Required

ResellerID

integer

Required

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

Sample:
// parameter to update the subscriber
 {
        "SubscriberID": 1, // mandatory, your subscriber id, integer
        "SubscriberCode": "DIT", //mandatory, your subscriber code, string
        "SubscriberName": "PT DIGITALINSTINCTS TECHNOLOGY", // mandatory , your 
        "CompanyName": "PT DIGITALINSTINCTS TECHNOLOGY",// mandatory, your company name, string
        "ContactPerson": "Kenny Marchel",// mandatory, the contact person, string
        "PhoneNumber": "6281398987393",// mandatory, your phone number, string
        "EmailAddress": "care@dit.co.id",// mandatory, the responsible email, string
        "CountryCode": "IDN",// mandatory, your country code, string
        "SubscriberToken": "1231edqssdwqdwqd", // mandatory, your subscriber token, string
        "LastUpdateBy": "ambar@dit.co.id",// mandatory, the responsible email, string
    }

application/xml, text/xml

Sample:
<Subscriber xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Traxia.Credential.Subscribers">
  <CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 13</CreatedBy>
  <CreatedTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+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 16</DiscardBy>
  <DiscardTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+07:00</DiscardTimeStamp>
  <GUID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 12</GUID>
  <LastUpdateBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 14</LastUpdateBy>
  <LastUpdateTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+07:00</LastUpdateTimeStamp>
  <SubscriberID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">11</SubscriberID>
  <CompanyName>sample string 3</CompanyName>
  <ContactPerson>sample string 4</ContactPerson>
  <CountryCode>sample string 7</CountryCode>
  <EmailAddress>sample string 6</EmailAddress>
  <GMT>8</GMT>
  <PhoneNumber>sample string 5</PhoneNumber>
  <ResellerID>10</ResellerID>
  <SubscriberCode>sample string 1</SubscriberCode>
  <SubscriberName>sample string 2</SubscriberName>
  <SubscriberToken>sample string 9</SubscriberToken>
</Subscriber>

multipart/form-data

Sample:
<Subscriber xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Traxia.Credential.Subscribers"><CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 13</CreatedBy><CreatedTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+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 16</DiscardBy><DiscardTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+07:00</DiscardTimeStamp><GUID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 12</GUID><LastUpdateBy xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">sample string 14</LastUpdateBy><LastUpdateTimeStamp xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">2024-12-18T15:31:48.3930057+07:00</LastUpdateTimeStamp><SubscriberID xmlns="http://schemas.datacontract.org/2004/07/Traxia.Common">11</SubscriberID><CompanyName>sample string 3</CompanyName><ContactPerson>sample string 4</ContactPerson><CountryCode>sample string 7</CountryCode><EmailAddress>sample string 6</EmailAddress><GMT>8</GMT><PhoneNumber>sample string 5</PhoneNumber><ResellerID>10</ResellerID><SubscriberCode>sample string 1</SubscriberCode><SubscriberName>sample string 2</SubscriberName><SubscriberToken>sample string 9</SubscriberToken></Subscriber>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

BaseResponse
NameDescriptionTypeAdditional 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

Sample:
// Succesful result of update subscriber 
{
    "Acknowledge": 1,
    "ResponseCode": 200,
    "ResponseMessage": "Request was succesfully performed.",
    "Data": "care@dit.co.id"
}