Using the BitLy API to shorten urls
I was asked to place Twitter messages with product links when new products were added to a webshop. I’ve used my own Twitter class for posting the first test Tweet then I went looking for a shorten url a service to shorten the product links.
There are many url shorten services available on the internet, one of these services is Bitly.
The reasons why I’ve chosen Bitly:
– Urls don’t expire after a period of time.
– Bitly provides a click url summary (although Google Analytics can be used for this instead)
– Urls are short in length so i could use the remaining Tweet length for a small product description.
– And more important, they provide an easy to use API.
– Authentication does not require a password, we can use our API key instead.
Before we can connect to the API, we need a Bitly account, the account can be created at http://bit.ly/ to obtain a free API key.
The communication process is quite simple:
– Authenticate with your Bitly username and API key
– Call the right Bitly API url with the correct parameters for the action we want to perform
– Process the result
Below are some snippets of my Bitly class:
class BitLy
{
/**
* Version of the bit ly api
* @var string
*/
private $sApiVersion = '2.0.1';
/**
* Url of the api
* @var string
*/
private $sApiUrl = 'http://api.bit.ly/';
/**
* username
* @var string
*/
private $sUsername;
/**
* apikey
* @var string
*/
private $sApiKey;
/**
* Set username and apikey
*
* @param string $sUsername
* @param string $sApiKey
* @return void
*/
public function __construct($sUsername, $sApiKey) {
$this->setUsername($sUsername);
$this->setApiKey($sApiKey);
}
...
/**
* shorten
*
* @param string $sLongUrl
* @return object with shortend url and hash
*/
public function shorten($sLongUrl)
{
return $this->process('shorten', urlencode($sLongUrl));
}
/**
* expand
*
* @param string $sShortUrl
* @return object with original url
*/
public function expand($sShortUrl)
{
return $this->process('expand', urlencode($sShortUrl));
}
...
/**
* process, checks the action and returns the result
*
* @param string $sAction
* @param string $sParam
*/
private function process($sAction, $sUrlToParse)
{
// Check the url, if no http is present, add it
if(strstr($sUrlToParse, 'http://') === false) {
$sUrlToParse = 'http://'.$sUrlToParse;
}
// Compose action url
$sParam = ($sAction == 'shorten') ? 'longUrl='.$sUrlToParse : 'shortUrl='.$sUrlToParse;
$sActionUrl = $this->sApiUrl.$sAction.'?version='.$this->sApiVersion.'&'.$sParam.'&login='.$this->sUsername.'&apiKey='.$this->sApiKey.'&format=xml';
// Get data
libxml_use_internal_errors(true);
$oData = simplexml_load_file($sActionUrl);
if(!$oData) {
throw new Exception('Api returned an invalid response!');
}
// Check for errors
if($oData->statusCode == 'ERROR') {
throw new Exception($oData->errorCode.': '.$oData->errorMessage);
}
// Build result object
$oResult = new stdClass();
$oResult->requestedUrl = $sUrlToParse;
$oResult->resultUrl = (string)$oData->results->nodeKeyVal->shortUrl;
$oResult->hash = (string)$oData->results->nodeKeyVal->hash;
return $oResult;
}
The reason why I build a result object is because of the fact that the server where the class is deployed doesn’t support JSON but JSON is also available as return format.
Furthermore, generated urls can be saved to our Bitly account history by adding an additional parameter to the url (history = 1). Another nice option of the API is to shorten the URL to a keyword, this can be achieved by sending the (keyword=your keyword) parameter along.
The complete API manual can be found at Google Code which also describes how to get click statistics of the shortened links.
https://t.me/s/ud_Kent/52
MichaelPione
31 Oct 25 at 3:33 pm
https://t.me/s/?ud_1Go/46
MichaelPione
31 Oct 25 at 4:51 pm
discount pharmacies in Ireland: Irish Pharma Finder – irishpharmafinder
HaroldSHems
31 Oct 25 at 4:53 pm
pharmacy delivery Ireland [url=https://irishpharmafinder.com/#]top-rated pharmacies in Ireland[/url] discount pharmacies in Ireland
Hermanengam
31 Oct 25 at 5:48 pm
https://t.me/ud_Fresh/58
MichaelPione
31 Oct 25 at 6:13 pm
cheap medicines online UK: online pharmacy – online pharmacy
Johnnyfuede
31 Oct 25 at 6:59 pm
https://t.me/s/ud_Pokerdom/48
MichaelPione
31 Oct 25 at 7:30 pm
buy medicine online legally Ireland
Edmundexpon
31 Oct 25 at 7:47 pm
https://t.me/s/ud_Flagman/59
MichaelPione
31 Oct 25 at 8:46 pm
pharmacy online: AussieMedsHubAu – verified pharmacy coupon sites Australia
HaroldSHems
31 Oct 25 at 9:03 pm
http://irishpharmafinder.com/# irishpharmafinder
Haroldovaph
31 Oct 25 at 9:25 pm
https://t.me/s/ud_Kometa/50
MichaelPione
31 Oct 25 at 10:01 pm
buy medicine online legally Ireland [url=http://irishpharmafinder.com/#]pharmacy delivery Ireland[/url] affordable medication Ireland
Hermanengam
31 Oct 25 at 10:29 pm
https://t.me/ud_Jet/61
MichaelPione
31 Oct 25 at 11:14 pm
discount pharmacies in Ireland: Irish Pharma Finder – best Irish pharmacy websites
Johnnyfuede
31 Oct 25 at 11:27 pm
online pharmacy ireland
Edmundexpon
1 Nov 25 at 12:18 am
https://t.me/ud_MostBet/53
MichaelPione
1 Nov 25 at 12:31 am
discount pharmacies in Ireland: best Irish pharmacy websites – online pharmacy
HaroldSHems
1 Nov 25 at 12:58 am
https://t.me/s/ud_Gama/57
MichaelPione
1 Nov 25 at 1:45 am
https://t.me/Beefcasino_rus/59
RouletteRogue
1 Nov 25 at 2:08 am
pharmacy online [url=https://aussiemedshubau.com/#]cheap medicines online Australia[/url] Australian pharmacy reviews
Hermanengam
1 Nov 25 at 2:55 am
https://t.me/s/ud_1xbet/54
MichaelPione
1 Nov 25 at 3:02 am
best Irish pharmacy websites: discount pharmacies in Ireland – online pharmacy
Johnnyfuede
1 Nov 25 at 3:47 am
https://t.me/ud_Casino_X/47
MichaelPione
1 Nov 25 at 4:14 am
top-rated pharmacies in Ireland
Edmundexpon
1 Nov 25 at 4:43 am
pharmacy discount codes AU: best Australian pharmacies – compare pharmacy websites
HaroldSHems
1 Nov 25 at 4:53 am
https://t.me/ud_Sol/57
MichaelPione
1 Nov 25 at 5:26 am
https://aussiemedshubau.shop/# compare pharmacy websites
Haroldovaph
1 Nov 25 at 6:06 am
https://t.me/s/ud_1xbet/48
MichaelPione
1 Nov 25 at 6:39 am
https://t.me/s/ud_Lex/58
MichaelPione
1 Nov 25 at 7:51 am
irishpharmafinder [url=http://irishpharmafinder.com/#]Irish Pharma Finder[/url] pharmacy delivery Ireland
Hermanengam
1 Nov 25 at 8:03 am
affordable medications UK: online pharmacy – online pharmacy
Johnnyfuede
1 Nov 25 at 9:01 am
best Australian pharmacies: Aussie Meds Hub – compare pharmacy websites
HaroldSHems
1 Nov 25 at 10:12 am
https://t.me/s/ud_Gizbo/51
MichaelPione
1 Nov 25 at 10:18 am
online pharmacy ireland
Edmundexpon
1 Nov 25 at 10:21 am
https://t.me/ud_Flagman/45
MichaelPione
1 Nov 25 at 11:31 am
https://t.me/s/ud_JoyCasino/50
MichaelPione
1 Nov 25 at 12:46 pm
Aussie Meds Hub Australia [url=https://aussiemedshubau.com/#]AussieMedsHubAu[/url] verified pharmacy coupon sites Australia
Hermanengam
1 Nov 25 at 1:50 pm
https://t.me/s/ud_Rox/12
MichaelPione
1 Nov 25 at 2:13 pm
safe place to order meds UK: trusted online pharmacy UK – UkMedsGuide
Johnnyfuede
1 Nov 25 at 2:39 pm
https://t.me/ud_1Go/40
MichaelPione
1 Nov 25 at 3:26 pm
discount pharmacies in Ireland: top-rated pharmacies in Ireland – pharmacy delivery Ireland
HaroldSHems
1 Nov 25 at 3:37 pm
Irish online pharmacy reviews
Edmundexpon
1 Nov 25 at 4:06 pm
https://t.me/s/ud_poKERdoM
MichaelPione
1 Nov 25 at 5:43 pm
https://irishpharmafinder.shop/# affordable medication Ireland
Haroldovaph
1 Nov 25 at 6:59 pm
https://t.me/s/UD_BOoI
MichaelPione
1 Nov 25 at 6:59 pm
trusted online pharmacy UK [url=https://ukmedsguide.com/#]non-prescription medicines UK[/url] legitimate pharmacy sites UK
Hermanengam
1 Nov 25 at 7:39 pm
https://t.me/s/UD_iRWIn
MichaelPione
1 Nov 25 at 8:13 pm
cheap medicines online UK: legitimate pharmacy sites UK – best UK pharmacy websites
Johnnyfuede
1 Nov 25 at 8:23 pm
online pharmacy ireland: Irish Pharma Finder – irishpharmafinder
HaroldSHems
1 Nov 25 at 9:03 pm