Download the PHP package adamculp/api-consumer without Composer
On this page you can find all versions of the php package adamculp/api-consumer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download adamculp/api-consumer
More information about adamculp/api-consumer
Files in adamculp/api-consumer
Package api-consumer
Short Description Basic API wrapper for dealing with Mashery and other GET based APIs.
License MIT
Informations about the package api-consumer
About
Simple PHP 7.3 class to consume an API through GET using Curl. (created to consume APIs, and could be used for other things) Methods build API URL params, connection url, and parse expected JSON response.
In the future I intend to add the possibility of an XML return as well, and may even break out the limited Curl functionality to another class, or simply use Guzzle.
Requirements
Requires PHP version 7.3 if namespaces are desired.
Installation
This class can be used directly from a GIT clone:
git clone https://github.com/adamculp/api-consumer.git
You could also download the ApiConsumer package and move the directory to a desired location where your scripts can then call it.
Alternatively you could simply copy the ApiConsumer.php file to a desired location and call it that way as well.
Non-Composer Usage
This class was written using namespaces available via PHP 5.3+, and if left unchanged would be used in the following manner: NOTE: This class contains information needed to utilize a certain Mashery API at Active.com, but you can change the URL and params as needed for other APIs that return JSON.
require_once 'path/to/src/ApiConsumer/Consumer.php';
use ApiConsumer\Consumer;
$apiConsumer = new Consumer();
$url = 'http://api.amp.active.com/search?';
$apiConsumer->setUrl($url);
$meta = 'meta:channel=Running+meta:startDate:daterange:today..' . date('Y-m-d', strtotime('next month'));
$params = array(
'k' => 'ultra+marathon',
'v' => 'json',
'l' => 'Florida',
'r' => '25',
's' => 'date_asc',
'api_key' => '{Add API Key Here}',
'm' => $meta
);
$options = array(); // key=>value pairs can be added here to alter the curl call
$apiConsumer->setParams($params);
$apiConsumer->setOptions($options);
$apiConsumer->setResponseType('json');
$apiConsumer->setCallType('get');
$result = $apiConsumer->doApiCall();
Composer Usage
After either installing Composer using one of the two methods shown at http://getcomposer.org the composer.json would look like:
{
"require": {
"adamculp/api-consumer": "dev-master"
}
}
Then you'll need to alter the require_once in the sample above to point to the Composer autoload instead of to the class itself.
require_once 'vendor/autoload.php'; // to include the composer autoloader
From there you can use the $result array as you see fit.
Please use the /api-consumer/index.php as a working example (minus the API key) of how the class can be included and used.