Skip to content
Bitly v4 API
PHP
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/PHPLicengine Update Api.php Nov 4, 2019
.gitignore Update .gitignore Nov 7, 2019
.travis.yml Update .travis.yml Nov 1, 2019
LICENSE Create LICENSE Oct 30, 2019
Readme.md Add comments to clarify Nov 7, 2019
Services.md Update Services.md Nov 4, 2019
composer.json Added new keywords Nov 7, 2019
phpunit.xml Update phpunit.xml Nov 1, 2019

Readme.md

Build Status Latest Stable Version Total Downloads Release date php License

Bitly API v4

Contents

Installation

composer require phplicengine/bitly

Usage

use PHPLicengine\Api\Api;
use PHPLicengine\Service\Bitlink;

$api = new Api("API KEY GOES HERE");
$bitlink = new Bitlink($api);
$result = $bitlink->createBitlink(['long_url' => 'http://www.example.com']);

// if cURL error occurs.
if ($api->isCurlError()) {
    
    print($api->getCurlErrno().': '.$api->getCurlError());
    
} else {

    // if Bitly response contains error message.
    if ($result->isError()) {

        print("Error:<br />");
        print($result->getResponse());
        print($result->getDescription());
    
    } else {
    
       // if Bitly response is 200 or 201
       if ($result->isSuccess()) {
        
          print("SUCCESS:<br />");
          print($result->getResponse());
          print_r($result->getResponseArray());

        } else {

          print("FAIL:<br />");
          print($result->getResponse());
          print_r($result->getResponseArray());

        }
    }
}

// for debug only.
print("INFO:<br />");

// returns response exactly as it is. e.g. json.
$resj = $result->getResponse();
print($resj."<br />");

// returns decoded json.
$reso = $result->getResponseObject();
print_r($reso);

// returns header of server.
$resh = $result->getHeaders();
print_r($resh);

// returns request.
$resh = $api->getRequest();
print_r($resh);

Manual

Service Classes

In Bitly API v4 documentations, resources are classified under serveral categories:

Bitlink, Group, Organization, User, Custom, Campaign, Bsd, App, Auth

We made each of them as a separate service class. Method names are the same as the last part of documentation url. For example if you want to use Get Metrics for a Bitlink by countries, this one is classified under Bitlink category in documentation and the last part of its url is getMetricsForBitlinkByCountries, so you can call it this way:

use PHPLicengine\Api\Api;
use PHPLicengine\Service\Bitlink;

$api = new Api("API KEY GOES HERE");
$bitlink = new Bitlink($api);
$result = $bitlink->getMetricsForBitlinkByCountries('bit.ly/34nRNvl', ['unit' => 'day', 'units' => -1]);

All Path parameters, must be passed as string in first argument of methods if necessary and all Query parameters must be passed as array in second argument of methods if necessary. If Path parameter is not needed, Query parameters will be first argument of methods.

Another example:

Retrieve Group Shorten Counts is classified under Group category, and the last part of its link is getGroupShortenCounts, so you can call it this way:

use PHPLicengine\Api\Api;
use PHPLicengine\Service\Group;

$api = new Api("API KEY GOES HERE");
$group = new Group($api);
$result = $group->getGroupShortenCounts($group_guid);

Here is list of available service classes and methods.

Custom cURL Options

By default cURL timeout is 30. You can change it with:

$api->setTimeout(30);

If you need to add some CURLOPT_* constants that are not enabled by default, you can call setCurlCallback() method to add them.

use PHPLicengine\Api\Api;
use PHPLicengine\Service\Bitlink;

$api = new Api("API KEY GOES HERE");
$api->setCurlCallback(function($ch, $params, $headers, $method) { 
      curl_setopt($ch, CURLOPT_*, 'some value'); 
}); 
$bitlink = new Bitlink($api);

This is added for your convenience, but you should not need it.

Caching

Since Bitlinks never change or expire, this is recommended to cache data locally wherever possible. This library comes with Doctrine Cache. You can use cache like this:

use PHPLicengine\Cache\Cache;
$factory = new Cache(['type' => 'file', 'path' => 'path/to/cache/folder']);
$cache = $factory->getCache();
$cache->save('key', 'value');
echo $cache->fetch('key'); // prints "value"

We suggest to look at Doctrine Cache Doc and investigate and customize Cache class to use preferred cache type.

Contributing and Support

For all issues or feature request or support questions please open a new issue. All pull requests are welcome.

License

PHPLicengine Api is distributed under the Apache License. See License.

You can’t perform that action at this time.