* @author Demian Katz * @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License * @link http://api.summon.serialssolutions.com/help/api/ API Documentation */ require_once 'Zend/Http/Client.php'; require_once dirname(__FILE__) . '/Base.php'; /** * Summon Search API Interface (Zend implementation) * * @category SerialsSolutions * @package Summon * @author Andrew Nagy * @author Demian Katz * @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License * @link http://api.summon.serialssolutions.com/help/api/ API Documentation */ class SerialsSolutions_Summon_Zend extends SerialsSolutions_Summon_Base { /** * The HTTP_Request object used for API transactions * @var object HTTP_Request */ protected $client; /** * Constructor * * Sets up the Summon API Client * * @param string $apiId Summon API ID * @param string $apiKey Summon API Key * @param array $options Associative array of additional options; * legal keys: *

*
• authedUser - is the end-user authenticated?
*
• debug - boolean to control debug mode
*
• host - base URL of Summon API
*
• sessionId - Summon session ID to apply
*
• version - API version to use
*
• responseType - Acceptable response (json or xml)
*

* @param Zend_Http_Client $client HTTP client object (optional) */ public function __construct($apiId, $apiKey, $options = array(), $client = null) { parent::__construct($apiId, $apiKey, $options); $this->client = is_object($client) ? $client : new Zend_Http_Client(); } /** * Handle a fatal error. * * @param SerialsSolutions_Summon_Exception $e Exception to process. * * @return void */ public function handleFatalError($e) { throw $e; } /** * Perform an HTTP request. * * @param string $baseUrl Base URL for request * @param string $method HTTP method for request * @param string $queryString Query string to append to URL * @param array $headers HTTP headers to send * * @throws SerialsSolutions_Summon_Exception * @return string HTTP response body */ protected function httpRequest($baseUrl, $method, $queryString, $headers) { $this->debugPrint( "{$method}: {$baseUrl}?{$queryString}" ); $this->client->resetParameters(); if ($method == 'GET') { $baseUrl .= '?' . $queryString; } elseif ($method == 'POST') { $this->client->setRawData( $queryString, 'application/x-www-form-urlencoded' ); } foreach ($headers as $key => $value) { $this->client->setHeaders($key, $value); } // Send Request $this->client->setUri($baseUrl); $result = $this->client->request($method); if ($result->isError()) { throw new SerialsSolutions_Summon_Exception($result->getBody()); } return $result->getBody(); } }