Ordering

Get orderform

GET /fast-events/v1/ordering/form/(string: token)

Get the order form for this token. You can use this API to embed the ordering form in you own html-code. Use the Shortcode tool to define the tokens and the shortcode. Shortcodes like: [fast_events id=2] or [fast_events group="OPENAIR"].

Example request

$ curl \
  -H "Content-Type: application/json" \
  https://exampledomain.com/wp-json/fast-events/v1/ordering/form/vintage

<?php
$ch = curl_init();
$url = 'https://exampledomain.com/wp-json/fast-events/v1/ordering/form/vintage';
curl_setopt($ch, CURLOPT_URL, $urls);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json')
);
$result = curl_exec($ch);
echo $result;

import requests
URL = 'https://exampledomain.com/wp-json/fast-events/v1/ordering/form/vintage'
response = requests.get(URL, headers=HEADERS, json=JSON)
print(response.json())

// This will inject the orderform in you frontend HTML and load the payment JS file.
<div id="fast-events-order-form"></div>
<script>
    document.addEventListener("DOMContentLoaded", async () => {

        const checkElement = async selector => {
            while (document.getElementById(selector) === null ) {
                await new Promise(resolve => requestAnimationFrame(resolve))
            }
            return document.getElementById(selector)
        }

        try {
            document.body.style.cursor = 'progress'
            let response = await fetch('https://example.com/wp-json/fast-events/v1/ordering/form/vinyl')
            const json = await response.json();
            if (response.ok) {
                document.getElementById('fast-events-order-form').innerHTML = json.form
                checkElement('fast-events-form-submit').then((selector) => {
                    let js = document.createElement('script')
                    js.src = '/js/fe-payment.min.js'
                    document.head.appendChild(js)
                })
            } else {
                if (json.code === 'rest_no_route') {
                    document.getElementById('remote-form-container').innerHTML =
                            '<div style="font-size:18px;color:#141619;background:#d4d4d4;margin-bottom:0!important;padding:1rem;border:1px solid rgb(188,190,191);border-radius:0.375rem">\
                                <p>The Ordering API is not enabled.</p>\
                            </div>'
                } else {
                    alert(json.message)
                }
            }
        } catch (error) {
            alert('Error: ' + error)
        } finally {
            document.body.style.cursor = 'default'
        }
    });
</script>

Example response

{
    "form": "\t\t<div class=\"fast-events-form-container\">\n\t  ......  <div id=\"fast-events-event-info\"></div>\n\n\t\t",
}

The form field is truncated. It will be empty if the shortcode can’t be found.

Example implementation

Below is sample implementation on how to use this REST API call in your own html page. After the Fast Event html order form is loaded, the javascript code in fe-payment.min.js is also loaded. This javascript code is part of the Fast Events plugin and can be found in the assets/js directory of the plugin. You should copy it to your own site.

<div id="fast-events-order-form"></div>
<script>
    document.addEventListener("DOMContentLoaded", async () => {

        const checkElement = async selector => {
            while (document.getElementById(selector) === null ) {
                await new Promise(resolve => requestAnimationFrame(resolve))
            }
            return document.getElementById(selector)
        }

        try {
            document.body.style.cursor = 'progress'
            let response = await fetch('https://exampledomain.com/wp-json/fast-events/v1/ordering/form/vintage')
            const json = await response.json();
            if (response.ok) {
                document.getElementById('fast-events-order-form').innerHTML = json.form
                checkElement('fast-events-form-submit').then((selector) => {
                    let js = document.createElement('script')
                    js.src = '/js/fe-payment.min.js'
                    document.head.appendChild(js)
                })
            } else {
                if (json.code === 'rest_no_route') {
                    document.getElementById('fast-events-order-form').innerHTML =
                        '<div style="font-size:18px;color:#141619;background:#d4d4d4;margin-bottom:0!important;padding:1rem;border:1px solid rgb(188,190,191);border-radius:0.375rem">\
                            <p>The ticket system is currently inactive.</p>\
                        </div>'
                } else {
                    alert(json.message)
                }
            }
        } catch (error) {
            alert('Error: ' + error)
        } finally {
            document.body.style.cursor = 'default'
        }
    });
</script>

Changelog

Version	Description
1.3.0	Introduced.

Get orderstatus

GET /fast-events/v1/ordering/status/(string: id)/(string: uid)

Retrieve the HTML-content for this order uid with id token using the defined shortcode. Use the Shortcode tool to define the tokens and the shortcode. Shortcodes like: [fe_download showimage="no" downloadtext="Download your tickets"] or [fe_personalise cdn].

Example request

$ curl \
  -H "Content-Type: application/json" \
  https://exampledomain.com/wp-json/fast-events/v1/ordering/status/STAT3/WzJQDnAvm7yswYzfSGVvro45q0IOScEXmdzzqO0K

<?php
$ch = curl_init();
$url = 'https://exampledomain.com/wp-json/fast-events/v1/ordering/status/STAT3/WzJQDnAvm7yswYzfSGVvro45q0IOScEXmdzzqO0K';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json')
);
$result = curl_exec($ch);
echo $result;

import requests
URL = 'https://exampledomain.com/wp-json/fast-events/v1/ordering/status/STAT3/WzJQDnAvm7yswYzfSGVvro45q0IOScEXmdzzqO0K'
response = requests.get(URL, headers=HEADERS)
print(response.json())

Example response

{
    "success": true,
    "form": "<img src=  ....  tickets</a>",
}

The form field is truncated. If the uid is not found or it doesnt have the right payment status the form field is empty and the success field is false.

Changelog

Version	Description
1.3.0	Introduced.
3.0.0	Changed the URL to include the shortcode token id.