Requesting Tech Availability - Slot Based
Introduction
Posting to SecurityTrax is done via raw http post. In order to perform this action you will need the following information:
URL |
|
Partner ID |
This is the unique ID that SecurityTrax assigns to the partner company. Source ID Provided by the company using SecurityTrax. |
Username |
Set by company using SecurityTrax. Provided by them. |
Password |
Set by company using SecurityTrax. Provided by them. |
Start Time |
Start time of the appointment in the customer’s time zone. 24 Hr format. |
End Time |
End time of the appointment in the customer’s time zone. 24 Hr format. |
Address Information |
Attributes for City, State, Zip, Address (street), Longitude, Latitude. The more detailed information passed the more accurate the response. |
Sample Request
The following is an example of a valid request.
<?xml version='1.0'?> <root> <requests> <request type='GetSystemAuthentication'> <attribute name='Username'>Username</attribute> <attribute name='Password'>Password</attribute> <attribute name='PartnerID'>PartnerID</attribute> </request> <request type="GetIfAppointmentAvailableByLocationInfo"> <attribute name="StartTime">01/23/2014 7:30</attribute> <attribute name="EndTime">01/23/2014 9:00</attribute> <attribute name="City">Provo</attribute> <attribute name="State">UT</attribute> <attribute name="Zip">84606</attribute> <attribute name="Address"></attribute> <attribute name="Latitude">40.2337</attribute> <attribute name="Longitude">-111.669</attribute> </request> <request type="GetIfAppointmentAvailableByLocationInfo"> <attribute name="StartTime">01/24/2014 7:30</attribute> <attribute name="EndTime">01/24/2014 9:00</attribute> <attribute name="City">White Hall</attribute> <attribute name="State">AR</attribute> <attribute name="Zip">71602</attribute> </request> </requests> </root>
Sample Response
The following is an example of a successful response.
<?xml version="1.0"?> <root> <responses> <response type="GetSystemAuthentication" success="true"> <data> <message>Authenticated To System</message> </data> <system_request> <request type="GetSystemAuthentication"> <attribute name="Username">brinks</attribute> <attribute name="Password">brinkspass</attribute> <attribute name="PartnerID">4</attribute> </request> </system_request> </response> <response type="GetIfAppointmentAvailableByLocationInfo" success="true"> <data> <available>false</available> </data> <system_request> <request type="GetIfAppointmentAvailableByLocationInfo"> <attribute name="StartTime">01/23/2014 7:30</attribute> <attribute name="EndTime">01/23/2014 9:00</attribute> <attribute name="City">Provo</attribute> <attribute name="State">UT</attribute> <attribute name="Zip">84606</attribute> <attribute name="Address"/> <attribute name="Latitude">40.2337</attribute> <attribute name="Longitude">-111.669</attribute> </request> </system_request> </response> <response type="GetIfAppointmentAvailableByLocationInfo" success="true"> <data> <available>true</available> </data> <system_request> <request type="GetIfAppointmentAvailableByLocationInfo"> <attribute name="StartTime">01/24/2014 7:30</attribute> <attribute name="EndTime">01/24/2014 9:00</attribute> <attribute name="City">White Hall</attribute> <attribute name="State">AR</attribute> <attribute name="Zip">71602</attribute> </request> </system_request> </response> </responses> </root>