Opsætning Af Dit Billetsystem Med API - Safeticket

Using the Safeticket Public API / XML feed

The Safeticket API provides a way to automatically get details about events, maintained by the customer in our database. Before you can use the public API it must first be activated by Safeticket.

Methods

There are basically two ways to fetch updated information about events.

• Periodically fetch everything with the “all” method.
• Periodically fetch the list of events with the “list” method and use the “modified” timestamps to determine the events that need updating. Then fetch each of these events using the “event” method.

All calls are done via https to the domain belonging to the given customer. If the domain is example.com and we e.g. want to call the “all” method, the URL to call will be “https://example.com/api/all”.

All

URL: https://example.com/api/all

This call returns details for all events:

<?xml version="1.0" encoding="UTF-8"?> <events> <event id="152"> <modified>2010-10-25T08:33:13+0200</modified> <title>Test 42</title> <venueid>123</venueid> <venue>Some venue</venue> <city>Aarhus</city> <category>Concerts</category> <date>2010-11-10</date> <time>19:00:00</time> <insale>true</insale> <soldout>false</soldout> <infourl>https://example.com/events/152-Test_42/</infourl> <buyurl>https://example.com/events/152-Test_42/ticket</buyurl> <teaser>Test</teaser> <description>Test</description> <photosmall> https://example.com/filestore/17b1ab0f6f6cd80bbdaf6decd13 </photosmall> <photolarge> https://example.com/filestore/85e7c8701663a96e119a34518d4 </photolarge> <ticketselection>count</ticketselection> <tickets> <ticket id="86"> <name>Gnyf</name> <section>Section</section> <seatmap></seatmap> <type>Standing</type> <price>10.00</price> <ticketfee>6.25</ticketfee> <shippingfee>30.00</shippingfee> <currency>DKK</currency> <vat>25%</vat> </ticket> <ticket id="87"> <name>Plop</name> <section>Section</section> <seatmap></seatmap> <type>Standing</type> <price>5.00</price> <ticketfee>6.25</ticketfee> <shippingfee>30.00</shippingfee> <currency>DKK</currency> <vat>25%</vat> </ticket> </tickets> <customfields> </customfields> </event> ... </events>

List

URL: https://example.com/api/list

This call returns the list of all events along with the time of last modification:

<?xml version="1.0" encoding="UTF-8"?> <events> <event id="152"> <modified>2010-10-25T08:33:13+0200</modified> <detailsurl>https://example.com/api/events/152</detailsurl> </event> <event id="12"> <modified>2010-10-25T08:33:13+0200</modified> <detailsurl>https://example.com/api/events/12</detailsurl> </event> ... </events>

Event

URL: https://example.com/api/events/<ID>

This call returns the details for one specific event:

<?xml version="1.0" encoding="UTF-8"?> <event id="152"> <modified>2010-10-25T08:33:13+0200</modified> <title>Test 42</title> <venue>Some venue</venue> <city>Aarhus</city> <category>Concerts</category> <date>2010-11-10</date> <time>19:00:00</time> <insale>true</insale> <soldout>false</soldout> <infourl>https://example.com/events/152-Test_42/</infourl> <buyurl>https://example.com/events/152-Test_42/ticket</buyurl> <teaser>Test</teaser> <description>Test</description> <photosmall> https://example.com/filestore/17b1ab0f6f6cd80bbdaf6decd13 </photosmall> <photolarge> https://example.com/filestore/85e7c8701663a96e119a34518d4 </photolarge> <ticketselection>count</ticketselection> <tickets> <ticket id="86"> <name>Gnyf</name> <section>Section</section> <seatmap></seatmap> <type>Standing</type> <price>10.00</price> <ticketfee>6.25</ticketfee> <shippingfee>30.00</shippingfee> <currency>DKK</currency> <vat>25%</vat> </ticket> <ticket id="87"> <name>Plop</name> <section>Section</section> <seatmap></seatmap> <type>Standing</type> <price>5.00</price> <ticketfee>6.25</ticketfee> <shippingfee>30.00</shippingfee> <currency>DKK</currency> <vat>25%</vat> </ticket> </tickets> <customfields> <customfield> <name>CUSTOM_ef_92</name> <description>Flaf</description> <emptyok>false</emptyok> <perticket>false</perticket> <tickets>all</tickets> </customfield> <customfield> <name>CUSTOM_ef_93</name> <description>Gnyf</description> <emptyok>true</emptyok> <perticket>true</perticket> <tickets>86,87</tickets> </customfield> </customfields> </event>

Notes

The intended use of this facility is to allow updating a local database that can be used when presenting the information.

Requesting the XML files or images from our servers on every page view is strongly discouraged.

If you have problems or questions, please contact us at api@safeticket.dk.We charge an hourly fee of DKK 995,00+VAT for support regarding the API.