API PLAYGROUND

Build your POST here and send to the listener by clicking "POST to listener"

a0			b0
a1			b1
a2			b2
a3			b3
a4			b4
a5			b5
a6			b6
a7			b7
a8			b8
a9			b9
debug

example wrapper class

<?php

class Public_Holidays_API
{
    //illustrates communication with the webservery public holidays API.
    //provides a workable wrapper class, if you don't mind my shonky coding
    //email me if you want any help, or want to help me - scott@webservery.com

    private $authenticating_user_email;
    private $authenticating_user_password;

    public $unix_time;
    public $state;
    public $result;

    public $status;   //holds the status of the last executed command.  200 indicates succes.
    public $error_description;  // if status <> 200 there will probably be a clue in this variable

    public function __construct($email,$password)
    {
$this->authenticating_user_email = $email;
$this->authenticating_user_password = $password;


    }
    public function __destruct()
    {
//nothing to do really
    }



    private function _fetch_xml_response($post_array)
    {

        //The parameter $post_array is converted to a string of urlencoded name-value pairs and then
        unset($url_encoded_post_array);
        foreach($post_array as $key => $value)
        { $url_encoded_post_array[$key] = urlencode($key)."=".urlencode($value);
        }
        $nvp_string = join("&",$url_encoded_post_array);

        //send to the API using curl
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        curl_setopt($ch, CURLOPT_URL, "https://www.webservery.com/services/public_holidays/listener.php");
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $nvp_string);
        curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
        curl_setopt($ch, CURLOPT_USERAGENT, "WebserveryPublicHolidaysWrapper/1.0 (+https://www.webservery.com)");
        curl_setopt($ch, CURLOPT_HTTPHEADER, array(
            "Accept: text/xml, application/xml, text/plain, */*",
            "Content-Type: application/x-www-form-urlencoded",
            "Connection: close"
        ));
        $xml_string = curl_exec($ch);
        $curl_errno = curl_errno($ch);
        $curl_error = curl_error($ch);
        $curl_http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $curl_content_type = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
        if(!$xml_string){
            $xml_string = "<?xml version='1.0' encoding='ISO-8859-1'?>
                            <response>
                                <b0>500</b0>
                                <b1>The API returned no data.  It shouldn't do that.  It's probably unwell.</b1>
                            </response>";
        }

        // Some server setups prepend warnings/notices before XML; strip to the response envelope if needed.
        $candidate_xml_string = $xml_string;
        $response_start = strpos($candidate_xml_string, "<response>");
        $response_end = strpos($candidate_xml_string, "</response>");
        if ($response_start !== false && $response_end !== false && $response_end > $response_start) {
            $candidate_xml_string = "<?xml version='1.0' encoding='ISO-8859-1'?>"
                . substr($candidate_xml_string, $response_start, ($response_end - $response_start) + strlen("</response>"));
        }

        libxml_use_internal_errors(true);
        $xml = simplexml_load_string($candidate_xml_string);
        if ($xml === false) {
            $xml_errors = libxml_get_errors();
            $xml_error_summary = "unknown xml parse error";
            if (!empty($xml_errors)) {
                $first_error = $xml_errors[0];
                $xml_error_summary = trim($first_error->message) . " (line " . $first_error->line . ")";
            }

            $posted_values = "";
            foreach ($post_array as $key => $value) {
                if ($posted_values !== "") {
                    $posted_values .= "&";
                }
                $posted_values .= $key . "=" . $value;
            }

            $response_snippet = substr(preg_replace('/s+/', ' ', (string)$xml_string), 0, 300);

            $fallback = "<?xml version='1.0' encoding='ISO-8859-1'?><response>";
            $fallback .= "<b0>500</b0>";
            $fallback .= "<b1>Invalid XML returned by API endpoint. http="
                . htmlspecialchars((string)$curl_http_code, ENT_XML1, 'ISO-8859-1')
                . " type=" . htmlspecialchars((string)$curl_content_type, ENT_XML1, 'ISO-8859-1')
                . " curl_errno=" . htmlspecialchars((string)$curl_errno, ENT_XML1, 'ISO-8859-1')
                . " curl_error=" . htmlspecialchars((string)$curl_error, ENT_XML1, 'ISO-8859-1')
                . " xml_error=" . htmlspecialchars($xml_error_summary, ENT_XML1, 'ISO-8859-1')
                . "</b1>";
            $fallback .= "<b2>post=" . htmlspecialchars($posted_values, ENT_XML1, 'ISO-8859-1')
                . " | response=" . htmlspecialchars($response_snippet, ENT_XML1, 'ISO-8859-1') . "</b2>";
            $fallback .= "</response>";
            $xml = simplexml_load_string($fallback);
        }
        libxml_clear_errors();

        return ($xml);
    }

public function check_date(){
            unset ($post);
            $post["a0"] = "check_by_unix_time";
            $post["a1"]         = $this->authenticating_user_email;
            $post["a2"] = $this->authenticating_user_password;
            $post["a3"] = $this->unix_time;
            $post["a4"] = $this->state;

            $response = $this->_fetch_xml_response($post);

            $this->status               = $response->b0;
            $this->error_description    = $response->b1;
            $this->result               = $response->b2;

}

    public function validation_table(){
            unset ($post);
            $post["a0"]     = "validation_table";
            $post["a1"]     = $this->authenticating_user_email;
            $post["a2"]     = $this->authenticating_user_password;

            $response = $this->_fetch_xml_response($post);

            $this->status               = $response->b0;
            $this->error_description    = $response->b1;
            $this->result               = urldecode($response->b2);

    }

    public function big_table(){



            unset ($post);
            $post["a0"] = "big_table";
            $post["a1"] = $this->authenticating_user_email;
            $post["a2"] = $this->authenticating_user_password;

            $response = $this->_fetch_xml_response($post);

            $this->status               = $response->b0;
            $this->error_description    = $response->b1;
            $this->result               = urldecode($response->b2);


    }

}