track123/open-api

Track123 Open API

Maintainers

Details

github.com/AndyMoxq/track123

Source

Issues

Installs: 3

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

V1.0.0 2025-04-23 06:13 UTC

Requires

  • php: >=8.1

MIT 51686565d2790714180f642d0b8902c60c7f2c35

This package is auto-updated.

Last update: 2025-05-25 03:26:38 UTC

README

Track123 OpenAPI SDK 是用于接入 Track123 海运/空运物流轨迹服务的 PHP 工具包。

📦 安装

使用 Composer 安装开发版本：

composer require track123/open-api

⚙️ 配置

use Track123\OpenApi\Config;

$config = new Config('your-access-token'); // 替换为你的 token

🚚 注册轨迹信息

use Track123\OpenApi\System\Request\OceanCargo\RegisterOceanCargoTrackingRequest;

$request = new RegisterOceanCargoTrackingRequest();
//单个添加
$request->addTracking('T001', 'CMA', 1)
        ->addTracking('T002', 'COSCO', 2);
$response = Track123::system($config)->registerOceanTrackings($request);
print_r($response -> getAcceptedData());
if($response -> hasRejectedData()){
    echo $response->getRejectedMessages();
}

🚚 查询海运轨迹

use Track123\OpenApi\System\Request\OceanCargo\GetOceanCargoTrackingsRequest;
use Track123\OpenApi\Track123;

$request = new GetOceanCargoTrackingsRequest();
$request->setTracking('order123', 'ONEYSZPF55508400', 2); // bill of lading
//或批量添加 
//$request->setTrackings($trackings);

$response = Track123::system($config)->getOceanCargoTrackings($request);

print_r($response->getAcceptedData());

if ($response->hasRejectedData()) {
    echo $response->getRejectedMessages();
}

📖 更多功能

  • 支持海运/空运注册、查询、删除轨迹
  • 承运商管理接口
  • 完善的类型校验、响应结构封装

📄 License

MIT License