PHPackages                             tychovbh/laravel-bluebillywig - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. tychovbh/laravel-bluebillywig

ActiveLibrary[API Development](/categories/api)

tychovbh/laravel-bluebillywig
=============================

A BlueBillyWig bridge for Laravel 5

v1.3(6y ago)077MITPHPPHP ^7.1.3

Since Oct 29Pushed 6y ago1 watchersCompare

[ Source](https://github.com/tychovbh/laravel-bluebillywig)[ Packagist](https://packagist.org/packages/tychovbh/laravel-bluebillywig)[ Docs](https://github.com/tychovbh/laravel-bluebillywig)[ RSS](/packages/tychovbh-laravel-bluebillywig/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (7)Versions (13)Used By (0)

Laravel Blue Billywig
=====================

[](#laravel-blue-billywig)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a1504ad2cfba65cc41a7112b35de992dbbfb3b7812f89c6597e1aa595c666324/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f747963686f7662682f6c61726176656c2d626c756562696c6c797769672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tychovbh/laravel-bluebillywig)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/1ceeb0eea14d34f2d9d25dd4ab94ff83dc6c78e87a31ec4943a92fa5e19087c3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f747963686f7662682f6c61726176656c2d626c756562696c6c797769672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tychovbh/laravel-bluebillywig)

Laravel Blue Billywig is created by, and is maintained by Tycho, and is a Laravel/Lumen package to connect with Blue Billywig API. Feel free to check out the [change log](CHANGELOG.md), [releases](https://github.com/tychovbh/laravel-bluebillywig/releases), [license](LICENSE.md), and [contribution guidelines](CONTRIBUTING.md)

Install
-------

[](#install)

Laravel Blue Billywig requires PHP 7.1 or 7.2. This particular version supports Laravel 5.5 - 5.7 only and Lumen.

To get the latest version, simply require the project using Composer.

```
$ composer require tychovbh/laravel-bluebillywig
```

Once installed, if you are not using automatic package discovery, then you need to register the `Tychovbh\Bluebillywig\BluebillywigServiceProvider` service provider in your `config/app.php`.

In Lumen add de Service Provider in `bootstrap/app.php`:

```
$app->register(\Tychovbh\Bluebillywig\BluebillywigServiceProvider::class);
```

Configuration
-------------

[](#configuration)

Laravel Blue Billywig requires publication configuration.

To get started, you'll need to publish all vendor assets:

```
$ php artisan vendor:publish --tag=laravel-bluebillywig
```

This will create a `config/bluebillywig.php` file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.

In lumen you have to create the configuration file manually since `vendor:publish` is not available. Create the file `config/bluebillywig.php` and copy paste the [example file](https://github.com/tychovbh/laravel-bluebillywig/blob/master/config/bluebillywig.php).

There are two config options:

##### Default publication Name

[](#default-publication-name)

This option (`'default'`) is where you may specify which of the publications below you wish to use as your default publication for all work. Of course, you may use many connections at once using the `$bluebillywig->publication('my_publication')` method. The default value for this setting is `'public'`.

##### Bluebillywig Publications

[](#bluebillywig-publications)

This option (`'publications'`) is where each of the publications are setup for your application. Example configuration has been included, but you may add as many publications as you would like.

Usage
-----

[](#usage)

##### Bluebillywig

[](#bluebillywig)

This is the class of most interest. This will send authenticated requests to Blue Billywig API. Go to their [documentation](https://support.bluebillywig.com/) for all available endpoints.

##### Real Examples

[](#real-examples)

Instantiate Bluebillywig class:

```
use Tychovbh\Bluebillywig\Bluebillywig;

// Use class injection
Route::get('/bluebillywig', function(Bluebillywig $bluebillywig) {
    $response = $bluebillywig->retrieve('/sapi/publication')
    return response()->json($response)
});

// Or use Laravel helper app()
Route::get('/bluebillywig', function() {
    $bluebillywig = app('bluebillywig');
    $response = $bluebillywig->retrieve('/sapi/publication')
    return response()->json($response)
});
```

Available Bluebillywig methods:

```
// The examples below use the default publication.
$response = $bluebillywig->retrieve('/sapi/mediaclip')
$response = $bluebillywig->retrieve('/sapi/mediaclip/' . $id)
$response = $bluebillywig->create('/sapi/mediaclip', $formData)
$response = $bluebillywig->update('/sapi/mediaclip/{id}', $id, $formData)
$response = $bluebillywig->delete('/sapi/mediaclip', $id)

// in this example we request data from my_publication.
// my_publication key should be added to publications in the confiugration file.
$response = $bluebillywig->publication('my_publication')->retrieve('/sapi/playlist')

// You can use other API endpoints like /json/mediaclip:
$response = $bluebillywig>retrieve('/json/mediaclip')
```

You can send parameters with some of the requests:

```
// Request with GET parameter 'limit=10'
$response = $bluebillywig->retrieve('/sapi/mediaclip', [
    'limit' => 10
])

// Create resource
$response = $bluebillywig->create('/sapi/mediaclip', [
    'title' => 'my fantastic new title',
])

// Update resource
$response = $bluebillywig->update('/sapi/mediaclip/{id}', $id, [
    'title' => 'my fantastic new title',
])
```

You will need to handle Exceptions from Bluebillywig yourself:

```
use Tychovbh\Bluebillywig\Exceptions\ConfigurationException;

try {
    $bluebillywig = app('bluebillywig');
    $bluebillywig->retrieve('/sapi/mediaclip')
} catch(\ConfigurationException $exception) {
    echo $exception->getMessage();
} catch(\GuzzleException $exception) {
    echo $exception->getMessage();
} catch(\Exception $exception) {
    echo $exception->getMessage();
}
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Testing
-------

[](#testing)

For testing `tests/feature/*` copy `tests/.env.example` to `tests/.env` and fill in your Blue Billywig testing account credentials.

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Tycho](https://github.com/tychovbh)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Total

12

Last Release

2503d ago

Major Versions

v0.9 → v1.02019-03-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/6600cf089af73eb1be53eb4c47bccd04794564d6e9c8d9386cd19ab2b42fd06e?d=identicon)[bespokeweb](/maintainers/bespokeweb)

---

Top Contributors

[![tychovbh](https://avatars.githubusercontent.com/u/5880561?v=4)](https://github.com/tychovbh "tychovbh (24 commits)")

---

Tags

tychovbhlaravel-bluebillywig

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/tychovbh-laravel-bluebillywig/health.svg)

```
[![Health](https://phpackages.com/badges/tychovbh-laravel-bluebillywig/health.svg)](https://phpackages.com/packages/tychovbh-laravel-bluebillywig)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)