README

为您的Laravel 5 Web应用程序提供简单的Qapla API集成。

安装

您可以通过Composer安装此包

$ composer require w3designweb/laravel-qapla

在Laravel 5.5及以上版本中，该包将自动注册服务提供者和外观。
在Laravel 5.4或以下版本中，首先注册包的服务提供者和外观

// config/app.php

'providers' => [
    ...
    W3design\Qapla\QaplaServiceProvider::class,
],

'aliases' => [
    ...
    'Qapla' => W3design\Qapla\QaplaFacade::class,
],

外观是可选的，但本指南的其余部分假设您正在使用外观。

接下来，发布配置文件

php artisan vendor:publish --provider="W3design\Qapla\QaplaServiceProvider" --tag="config"

用法

连接到频道

use W3design\Qapla\Qapla;
...
$channel = new Qapla($privateApiKey, $publicApiKey);

之后，您可以使用以下所有功能

getTrack()：通过跟踪号码返回运输状态。
pushTrack()：允许通过POST请求以JSON格式加载一个或多个运输。
deleteTrack()：允许您通过"trackingNumber"删除运输。
getTracks()：返回从Qapla导入的运输列表，每次调用最多100个运输。
pushOrder()：允许您通过POST请求以JSON格式加载一个或多个订单。
getOrders()：返回从Qapla导入的订单列表，每次调用最多100个订单。
getCredits()：返回您高级账户剩余的信用额度。
getCouriers()：返回快递列表，可以是总列表，也可以是单个国家/地区的列表。

getTrack()

使用跟踪号码返回运输状态。
您可以通过"trackingNumber"或"reference"检索跟踪。

$track = $channel->getTrack('trackingNumber', '2878202252347', 'ita');	// by "trackingNumber"
$track = $channel->getTrack('reference', '300008236', 'ita');		// by "reference"

pushTrack()

允许通过POST请求以JSON格式加载一个或多个运输。
PHP中的$data数组必须遵循此处描述的指南：https://api.qapla.it/#pushTrack

$data = array(...);
$channel->pushTrack($data);

deleteTrack()

允许您通过"trackingNumber"删除运输。

$channel->deleteTrack('2878202252347');

getTracks()

返回从Qapla导入的运输列表，每次调用最多100个运输。
您必须指定"startDate"，可以使用格式"Y-m-d H:i:s"的日期或表示"36天前"的整数，如"36"。

$tracks = $channel->getTracks('2015-05-21 00:00:00');	// With "Y-m-d H:i:s" format
$tracks = $channel->getTracks('36');			// With "days" format

getOrders()

返回从Qapla导入的订单列表，每次调用最多100个订单。
您必须指定"startDate"，可以使用格式"Y-m-d H:i:s"的日期或表示"36天前"的整数，如"36"。

$orders = $channel->getOrders('2015-05-21 00:00:00');	// With "Y-m-d H:i:s" format
$orders = $channel->getOrders('36');			// With "days" format

pushOrder()

允许您通过POST请求以JSON格式加载一个或多个订单。
PHP中的$data数组必须遵循此处描述的指南：https://api.qapla.it/#pushOrder

$data = array(...);
$channel->pushOrder($data);

getCredits()

返回您高级账户剩余的信用额度。

$credits = $channel->getCredits();

getCouriers()

返回快递列表，可以是总列表，也可以是单个国家/地区的列表。

$couriers = $channel->getCouriers();

Qapla

您运输的最佳伴侣。

对问题运输的完全控制
在一个仪表板上支持59个快递
状态自动更新和自定义跟踪页面
交易电子邮件和支持票据
多店铺和多平台集成

文档

网站：https://www.qapla.it
API：https://api.qapla.it
Webhook：https://webhook.qapla.it

变更日志

有关最近更改的详细信息，请参阅CHANGELOG。

贡献指南

有关详细信息，请参阅CONTRIBUTING。

安全

如果您发现任何与安全相关的问题，请通过电子邮件:author_email联系，而不是使用问题跟踪器。

鸣谢

许可协议

MIT许可协议（MIT）。有关更多信息，请参阅许可文件。

w3designweb / laravel-qapla

维护者

详细信息