Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A fuel cell providing easy use of the various public APIs.
PHP
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
classes
config
README.md
bootstrap.php

README.md

fuel-api

This cell is designed to be used once you have already authorised and have your token. It uses the OAuth Cell Package for making requests for OAuth powered APIs. You can also use it for other APIs, including OAuth2 based. Integrated pagination is planned.

Providers

The following list of providers are currently supported, feel free to fork and add your own too.

  • Asana
  • Dropbox
  • Facebook
  • Flickr
  • Foursquare
  • Github
  • Instagram
  • Last.fm
  • LinkedIn
  • MailChimp
  • Postmark
  • Tumblr
  • Twitter
  • Twtmore
  • Vimeo

Usage

Remember to load copy the config files into your app/config directory. I would recommend setting them to auto load.

Twitter (OAuth)

<?php

function get_tweets()
{
    $provider = 'twitter';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $twitter = Api::forge($provider, $options);

    try
    {
        $tweets = $twitter->get('statuses/user_timeline', array(
            'screen_name' => 'm4tthumphrey',
            'count' => 2,
            'include_rts' => true
        ));
    }
    catch (Api\ApiException $e)
    {
        $tweets = array();
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $tweets;
}

public function post_tweet()
{
    $provider = 'twitter';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $twitter = Api::forge($provider, $options);

    try
    {
        $tweet = $twitter->post('statuses/update', array(
            'status' => 'This is a test tweet from fuel-api'
        ));
    }
    catch (Api\ApiException $e)
    {
        $tweet = null;
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $tweet;
}

Foursquare (OAuth2)

<?php

function get_trending_venues($ll = '40.7,-74')
{
    $provider = 'foursquare';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $fs = Api::forge($provider, $options);

    try
    {
        $venues = $fs->get('venues/trending', array(
            'll' => $ll
        ))->venues;

    }
    catch (Api\ApiException $e)
    {
        $venues = array();
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $venues;
}

Instagram (OAuth2)

<?php

function get_feed()
{
    $provider = 'instagram';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $instagram = Api::forge($provider, $options);

    try
    {
        $feed = $instagram->get('users/self/feed');
    }
    catch (Api\ApiException $e)
    {
        $feed = array();
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $feed;
}

Facebook (OAuth2)

We use the Graph API when making requests to Facebook. Remember this is for use once authenticated and you have a valid token. Make sure you authenicate with the necessary permissions to be able to complete the requests.

<?php

function update_status()
{
    $provider = 'facebook';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $fb = Api::forge($provider, $options);

    try
    {
        $status_id = $fb->post('me/feed', array(
            'message' => 'This is a test update from fuel-api'
        ));
    }
    catch (Api\ApiException $e)
    {
        $status_id = null;
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $status_id;
}

Last.fm

<?php

function shout()
{
    $provider = 'lastfm';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $lfm = Api::forge($provider, $options);

    try
    {
        $lfm->post('user.shout', array(
            'user' => 'm4tthumphrey',
            'message' => 'This is a test shout from fuel-api'
        ));
    }
    catch (Api\ApiException $e)
    {
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }
}

Asana (HTTP Auth Basic)

<?php

function user_info()
{
    $provider = 'asana';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $asana = Api::forge($provider, $options);

    try
    {
        $user = $asana->get('users/me');
    }
    catch (Api\ApiException $e)
    {
        $user = null;
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $user;
}

Postmark

<?php

function send_email()
{
    $provider = 'postmark';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $postmark = Api::forge($provider, $options);

    try
    {
        $message = $postmark->post('send', array(
            'To' => 'user@example.com',
            'From' => 'send@example.com',
            'Subject' => 'Hi there!',
            'TextBody' => 'Hi!'
        ));
    }
    catch (Api\ApiException $e)
    {
        $message = null;
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $message;
}

Twtmore

<?php

function get_tweet()
{
    $provider = 'twtmore';
    if (($options = Config::load($provider)) === false) {
        $options = Config::get($provider);
    }

    $twtmore = Api::forge($provider, $options);

    try
    {
        $tweet = $twtmore->post('tweet', array(
            'id' => 'A'
        ));
    }
    catch (Api\ApiException $e)
    {
        $tweet = null;
        logger(\Fuel::L_ERROR, $e->getMessage(), __METHOD__);
    }

    return $tweet;
}
Something went wrong with that request. Please try again.