Bitly API v3 PHP Class This is a PHP class library for interacting with the v3 bit.ly api (only deals with JSON format, but supports new OAuth endpoints)

============== REQUIREMENTS:

PHP, Curl, JSON

====== TODO:

• More formats (I don't like JSON)
  
• More features per users recommendations
  

Send your wishes and recommendations to my Email.

======== EXAMPLES

There are two example files which should get you know how it works.
Also it should teach you how to construct your code to use this class.

====== USAGE:

1. Simply download the bitly.class.php file and include it in your project directory
   

2. Now you have to define class, there are two ways:
   

   • Method 1: Just before inclusion of bitly.class.php put this line: define("bitlyPHP_init", "bitly");
     
   • Method 2: $bitly = new PHPBitlyAPIv3;
     !WARNING! Only ONE method should be used!
     

3. To set own login and API keys - In your project make following calls (Before use):
   $bitly->setAPI("API", "YOUR_API_KEY");
   $bitly->setAPI("LOGIN", "YOUR_BITLY_USERNAME");
   $bitly->setAPI("CLIENT->ID", "YOUR_CLIENT_ID");
   $bitly->setAPI("CLIENT->SECRET", "YOUR_CLIENT_SECRET");
   
   

4. Make sure to include the file whenever you want to access the bitly api functionality... include_once('bitly.class.php');
- Remember: If you want to use Method 1 of initialization you must define it just before inclusion

5. Use any of the functions as such:
   

$results = $bitly->shorten('http://knowabout.it', 'USERS_ACCESS_TOKEN', 'j.mp');

$results = $bitly->expand('dYhyia');

$results = $bitly->expand(array('http://bit.ly/dYhyia','http://j.mp/dYhyia'));

$result = $bitly->validate('USERS_LOGIN','USERS_APIKEY');

$results = $bitly->clicks('dYhyia');

$results = $bitly->clicks(array('dYhyia','http://bit.ly/dYhyia'));

$results = $bitly->referrers('grqSlY');

$results = $bitly->countries('grqSlY');

$results = $bitly->clicks_by_minute(array('grqSlY','dYhyia'));

$results = $bitly->clicks_by_day(array('grqSlY','dYhyia'));

$results = $bitly->bitly_pro_domain('nyti.ms');

$results = $bitly->lookup('http://knowabout.it');

$results = $bitly->lookup(array('http://knowabout.it','http://blog.botfu.com'));

$results = $bitly->authenticate('USERS_LOGIN','USERS_PASSWORD');

$results = $bitly->info(array('grqSlY','dYhyia'));

$results = $bitly->oauth_access_token('CODE_ASSIGNED_BY_BITLY',
'THE_URL_YOU_WANT_BITLY_TO_REDIRECT_TO_WHEN_APP_IS_APPROVED_BY_USER');

$results = $bitly->user_clicks('USERS_ACCESS_TOKEN');

$results = $bitly->user_referrers('USERS_ACCESS_TOKEN');

$results = $bitly->user_countries('USERS_ACCESS_TOKEN');

$results = $bitly->user_realtime_links('USERS_ACCESS_TOKEN');

$results = $bitly->highvalue('USERS_ACCESS_TOKEN');

$results = $bitly->search('USERS_ACCESS_TOKEN', 'awesome');

$results = $bitly->realtime_bursting_phrases('USERS_ACCESS_TOKEN');

$results = $bitly->realtime_hot_phrases('USERS_ACCESS_TOKEN');

$results = $bitly->realtime_clickrate('USERS_ACCESS_TOKEN', 'awesome');

$results = $bitly->link_info('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

$results = $bitly->link_content('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

$results = $bitly->link_category('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

$results = $bitly->link_social('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

$results = $bitly->link_location('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

$results = $bitly->link_language('USERS_ACCESS_TOKEN', 'http://bit.ly/S4qgbT');

============= SPECIAL NOTE:

To use the new OAuth endpoints, you must first obtain an access token for a user. You do this by passing the user off to bit.ly to approve your apps access to their account...and then you use the return code along with the
bitly_oauth_access_token method to obtain the actual bitly access token:

1. Present the user with a link as such Authorize giftabit

2. a code ($_REQUEST['code']) will be supplied as a param to the url Bit.ly redirects to...so you can then execute $results = bitly_oauth_access_token($_REQUEST['code'], 'THE_URL_YOU_WANT_BITLY_TO_REDIRECT_TO_WHEN_APP_IS_APPROVED_BY_USER');

3. If everything goes correctly, you should now have a $results['access_token'] value that you can use with the oauth requests for that user.

=============== SPECIAL THANKS:

Kevin Marshall (https://github.com/Falicon) - Original author, for great job he did.
Robin Monks (https://github.com/mozillamonks) - for great additional documentation and general suggestions/improvements.

======== CONTACT:

As always, if you've got any questions, comments, or concerns about
anything you find here, please feel free contact me at
email: xzero@elite7hackers.net or xzero707@gmail.com
Twitter: @xZeroOfficial -> https://twitter.com/xZeroOfficial
Facebook: https://www.facebook.com/Aleks.xZero

Original author:
As always, if you've got any questions, comments, or concerns about
anything you find here, please feel free to drop me an email at info@falicon.com or find me on Twitter @falicon

======== License:

Object oriented version - Copyright 2015 xZero.
Original work - Copyright 2010 Kevin Marshall

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/.