GatherContent API example (v0.4)

gathercontent_api_v0_4.php

<?php

class Example_API {

    private $api_url;
    private $api_key;
    private $password;

    /**
     * Class Constructor
     *
     * @access public
     * @return null
     */

    public function __construct()
    {
        $this->api_url = 'https://accountname.gathercontent.com/api/0.4/';
        $this->api_key = '64-characters-long-api-key';
        $this->password = 'x'; // leave it as 'x'
    }

    /**
     * Function test_api
     *
     * Few test calls to GatherContent API
     *
     * @access public
     * @return null
     */

    public function test_api()
    {
        $query = $this->_curl('get_me');
        echo 'Me:<br>';
        echo 'Response code: '.$query['code'].'<br>';
        echo '<pre>';
        print_r(json_decode($query['response']));
        echo '</pre>';

        $query = $this->_curl('get_my_group');
        echo 'My group:<br>';
        echo 'Response code: '.$query['code'].'<br>';
        echo '<pre>';
        print_r(json_decode($query['response']));
        echo '</pre>';

        //non-existing group, will return an error 404
        $query = $this->_curl('get_group', array('id' => 123456789));
        echo 'Group 123456789:<br>';
        echo 'Response code: '.$query['code'].'<br>';
        echo '<pre>';
        print_r(json_decode($query['response']));
        echo '</pre>';

        exit();
    }

    /**
     * Function _curl
     *
     * Using cURL to access GatherContent API
     *
     * @access private
     * @param string
     * @param array
     * @return array
     */

    private function _curl($command = '', $postfields = array())
    {
        $postfields = http_build_query($postfields);
        $session = curl_init();

        curl_setopt($session, CURLOPT_URL, $this->api_url.$command);
        curl_setopt($session, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
        curl_setopt($session, CURLOPT_HEADER, false);
        curl_setopt($session, CURLOPT_HTTPHEADER, array('Accept: application/json', 'Content-Type: application/x-www-form-urlencoded'));
        curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($session, CURLOPT_USERPWD, $this->api_key . ":" . $this->password);
        curl_setopt($session, CURLOPT_POST, true);
        curl_setopt($session, CURLOPT_POSTFIELDS, $postfields);

        if (substr($this->api_url, 0, 8) == 'https://') {
            curl_setopt($session, CURLOPT_SSL_VERIFYPEER, true);
        }

        $response = curl_exec($session);
        $httpcode = curl_getinfo($session, CURLINFO_HTTP_CODE);
        curl_close($session);

        return array( 'code' => $httpcode, 'response' => $response );
    }
}