Ero sivun ”ITSFactory siriaccess developerguide” versioiden välillä
(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 | 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. | 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:
- http://178.217.134.37:8080/siriaccess/vm/siri (SIRI XML documents over HTTP POST)
- http://178.217.134.37:8080/siriaccess/vm/rest (SIRI JSON documents over HTTP GET)
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.