Wrapper around ShipEngine API
You can install the package via composer:
composer require always-open/shipengineYou can publish the config file with:
php artisan vendor:publish --tag="shipengine-config"This is the contents of the published config file:
return [
/*
|--------------------------------------------------------------------------
| ShipEngine configurations
|--------------------------------------------------------------------------
|
| API Key used to authenticate with ShipEngine APIs.
| https://www.shipengine.com/docs/auth/
|
*/
'credentials' => [
'key' => env('SHIP_ENGINE_API_KEY'),
],
/*
|--------------------------------------------------------------------------
| ShipEngine configurations
|--------------------------------------------------------------------------
|
| Values used to set configuration of ShipEngine API integration.
|
*/
'endpoint' => [
'version' => env('SHIP_ENGINE_API_VERSION', 'v1'),
'base' => env('SHIP_ENGINE_ENDPOINT', 'https://api.shipengine.com/'),
],
'retries' => env('SHIP_ENGINE_RETRIES', 1),
'response' => [
'as_object' => env('SHIP_ENGINE_RESPONSE_AS_OBJECT', false),
'page_size' => env('SHIP_ENGINE_RESPONSE_PAGE_SIZE', 50),
],
'timeout' => 'PT10S',
];To use the ShipEngine wrapper you must first instantiate a new instance.
By default, the config information is read out of the config file but can be overridden on the fly. This can be done when instantiating a new instance, which will impact all subsequent calls, or when making the call.
// Use default config settings from `config/shipengine.php`
$shipengine = new AlwaysOpen\ShipEngine\ShipEngine();
// Override config which will impact all calls made with this instance
$config = new \AlwaysOpen\ShipEngine\ShipEngineConfig(['asObject' => true]);
$custom_shipengine = new AlwaysOpen\ShipEngine\ShipEngine($config);
// Override config on a single specific call
$shipengine->listShipments(config: ['asObject' => true]);To make calls to the ShipEngine API you must have credentials setup within ShipEngine itself. Those API credentials will then be used by this library to handle the calls and responses.
NOTE: This library is still in the 0.x.x stages and not all endpoints are fully mapped. We are working towards 100% coverage of existing API endpoints.
Method names should match documentation names of API endpoints from official ShipEngine API Docs.
Here is a sample of how to get a listing of shipments as well as the difference between asObject => false and asObject => true.
$shipengine = new AlwaysOpen\ShipEngine\ShipEngine();
$shipengine->listShipments();
//[
// "shipments" => [
// [
// "shipment_id" => "se-123456789",
// "carrier_id" => "se-123456",
// ...
// ],
// [...],
// ],
// "total" => 12,
// "page" => 1,
// "pages" => 1,
// "links" => [
// "first" => [
// "href" => "https://api.shipengine.com/v1/shipments?page=1&page_size=25",
// ],
// "last" => [
// "href" => "https://api.shipengine.com/v1/shipments?page=1&page_size=25",
// ],
// "prev" => [],
// "next" => [],
// ],
//];
$shipengine->listShipments(config: ['asObject' => true]);
// [
// "shipments" => [
// AlwaysOpen\ShipEngine\DTO\Shipment {#4070
// +shipment_id: "se-123456789",
// +carrier_id: "se-123456",
// ...
// ],
// [...],
// ],
// "total" => 12,
// "page" => 1,
// "pages" => 1,
// "links" => [
// "first" => [
// "href" => "https://api.shipengine.com/v1/shipments?page=1&page_size=25",
// ],
// "last" => [
// "href" => "https://api.shipengine.com/v1/shipments?page=1&page_size=25",
// ],
// "prev" => [],
// "next" => [],
// ],
//];composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.