Ero sivun ”ITSFactory siriaccess developerguide” versioiden välillä

ITS Factory Developer Wikistä
(Created page with "During its beta phase, the ITS Factory SIRI Access responds to requests in urls: * http://178.217.134.37:8080/siriaccess/vm/siri (SIRI XML documents over HTTP POST) * http://1...")
 
Ei muokkausyhteenvetoa
Rivi 10: Rivi 10:
The URL supports standard SIRI XML document exchange as defined in http://www.kizoom.com/standards/siri/, the SIRI version is 1.3 as defined in http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd
The URL supports standard SIRI XML document exchange as defined in http://www.kizoom.com/standards/siri/, the SIRI version is 1.3 as defined in http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd


To communicate with this URL, the client must send XML formatted SIRI requests via HTTP POST. The server will response with proper SIRI XML response. SIRI Subscriptions are not supported by this URL. A minimalistic request to access all vehicle data is as follows:
To communicate with this URL, the client must send XML formatted SIRI requests via HTTP POST. The server will response with proper SIRI XML response. SIRI Subscriptions are not supported by this URL. A minimalist request to access all vehicle monitoring data is as follows:


<pre>
<pre>
Rivi 24: Rivi 24:
</pre>
</pre>


 
To access vehicle monitoring data for certain line, a minimalist request would be:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3"
xsi:schemaLocation="http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd">
<ServiceRequest>
<VehicleMonitoringRequest version="1.3">
<LineRef>23</LineRef>
</VehicleMonitoringRequest>
</ServiceRequest>
</Siri>
</pre>
To access vehicle monitoring data for certain vehicle, a minimalist request would be:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3"
xsi:schemaLocation="http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd">
<ServiceRequest>
<VehicleMonitoringRequest version="1.3">
<VehicleRef>TKL_123</VehicleRef>
</VehicleMonitoringRequest>
</ServiceRequest>
</Siri>
</pre>
== SIRI JSON documents over HTTP GET ==
== SIRI JSON documents over HTTP GET ==




Rest access responds to HTTP GET requests and returns JSON formatted textual data. The data
Rest access responds to HTTP GET requests and returns JSON formatted textual data.

Versio 14. syyskuuta 2013 kello 15.44

During its beta phase, the ITS Factory SIRI Access responds to requests in urls:

Both URLs will support following SIRI modules:

  • Vehicle Monitoring, VM (Currently available in beta phase)
  • General Messaging, GM (Currently not available, planned)

SIRI XML documents over HTTP POST

The URL supports standard SIRI XML document exchange as defined in http://www.kizoom.com/standards/siri/, the SIRI version is 1.3 as defined in http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd

To communicate with this URL, the client must send XML formatted SIRI requests via HTTP POST. The server will response with proper SIRI XML response. SIRI Subscriptions are not supported by this URL. A minimalist request to access all vehicle monitoring data is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3" 
  xsi:schemaLocation="http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd">
	<ServiceRequest>
			<VehicleMonitoringRequest version="1.3">
				<VehicleMonitoringRef>VEHICLES_ALL</VehicleMonitoringRef>
			</VehicleMonitoringRequest>
	</ServiceRequest>
</Siri>

To access vehicle monitoring data for certain line, a minimalist request would be:

<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3" 
	xsi:schemaLocation="http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd">
	<ServiceRequest>
			<VehicleMonitoringRequest version="1.3">
				<LineRef>23</LineRef>
			</VehicleMonitoringRequest>
	</ServiceRequest>
</Siri>

To access vehicle monitoring data for certain vehicle, a minimalist request would be:

<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3" 
	xsi:schemaLocation="http://www.kizoom.com/standards/siri/schema/1.3/siri.xsd">
	<ServiceRequest>
			<VehicleMonitoringRequest version="1.3">
				<VehicleRef>TKL_123</VehicleRef>
			</VehicleMonitoringRequest>
	</ServiceRequest>
</Siri>

SIRI JSON documents over HTTP GET

Rest access responds to HTTP GET requests and returns JSON formatted textual data.