README

这是一个用于管理TrackingMore API的Laravel包。

TrackingMore帮助电子商务企业高效更新和管理他们的运输。

此包是TrackingMore API PHP SDK的Laravel包装器。

版本支持

• PHP: 8.0 | 8.1 | 8.2
• Laravel: 10.0

安装

您可以通过composer从Packagist进行安装。

$ composer require anvari182/laravel-tracking-more

配置

在您的.env文件中添加TRACKING_MORE_API_KEY。

从TrackingMore获取您的TrackingMore API密钥

php artisan vendor:publish --provider="Anvari182\TrackingMore\TrackingMoreServiceProvider" --tag="config"

使用方法

在需要的地方注入跟踪或快递

use Anvari182\TrackingMore\TrackingMoreRequests\Tracking;
use Anvari182\TrackingMore\TrackingMoreRequests\Courier;
use Anvari182\TrackingMore\Data\TrackingData;

public function __construct(private Tracking $tracking, private Courier $courier)
{
}

public function index()
{
   // Create a tracking
   $this->tracking->createTracking(['tracking_number' => 'xyz123', 'courier_code' => 'ups']);
   
   // Get all couriers
   $couriers = $this->courier->getAllCouriers();
}

或使用外观

use Anvari182\TrackingMore\Facades\TrackingMore;

// Create a tracking
TrackingMore::tracking()->createTracking(['tracking_number' => 'xyz123', 'courier_code' => 'ups'])

 // Get all couriers
$couriers = TrackingMore::courier()->getAllCouriers();

跟踪

创建跟踪

TrackingMore::tracking()->createTracking(['tracking_number' => 'xyz123', 'courier_code' => 'ups'])

获取结果

TrackingMore::tracking()->getTrackingResults()

创建跟踪

创建多个跟踪（一次调用中最多创建40个跟踪号码）。

 TrackingMore::tracking()->batchCreateTrackings([
        ['tracking_number' => 'xyz1234', 'courier_code' => 'ups'],
        ['tracking_number' => 'xyz1235', 'courier_code' => 'ups'],
        ['tracking_number' => 'xyz1236', 'courier_code' => 'ups'],
    ]);

通过ID更新跟踪

跟踪ID

TrackingMore::tracking()->updateTrackingByID('13123213213213', ['note' => 'New test order note', 'customer_name'=>'New name'])

通过ID删除跟踪

跟踪ID

TrackingMore::tracking()->deleteTrackingByID('13123213213213')

通过ID重新跟踪过期的跟踪

跟踪ID

TrackingMore::tracking()->retrackTrackingByID('13123213213213')

快递

检测快递

根据提交的跟踪号码返回匹配的快递列表。

TrackingMore::courier()->detect(['tracking_number' => '9261290312833844954982'])

获取所有快递

返回所有支持的快递列表。

TrackingMore::courier()->getAllCouriers()

依赖

TrackingMore API PHP SDK v.1.0.0

贡献

欢迎提交拉取请求。对于重大更改，请先提交一个问题来讨论您希望更改的内容。

请确保适当更新测试。

许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。