stdmedoth/lalamove-php-sdk

LalamovePHP-SDK 仓库是 PHP 开发者将 Lalamove 的即时配送功能集成到其应用程序中的理想解决方案。

1.0.0 2023-02-27 21:19 UTC

This package is auto-updated.

Last update: 2024-09-28 01:57:06 UTC


README

LalamovePHP-SDK 是一个 PHP 库,为开发者提供了连接到 Lalamove 即时配送服务的简单易用的接口。使用此 SDK,开发者可以进行身份验证、创建报价、创建订单和检索订单详情。

身份验证

要使用 LalamovePHP-SDK,您必须首先通过 Lalamove 的 API 进行身份验证。您可以从 Lalamove 开发者门户获取您的 API 凭据。一旦您有了凭据,您可以创建 SDK 的实例并设置 API 密钥、API 密钥、市场和环境

require_once 'vendor/autoload.php';

use stdmedoth\LalamovePhpSdk;

$api_key = 'YOUR_API_KEY';
$api_secret = 'YOUR_API_SECRET';
$market = 'YOUR_MARKET'; // e.g. 'SG'
$environment = 'YOUR_ENVIRONMENT'; // either 'product' or 'sandbox'

$lalamove = new LalamovePhpSdk($api_key, $api_secret, $market, $environment);

创建报价

要创建报价,您需要提供以下信息

  • serviceType:服务类型。此参数是必需的,可以从服务端点获取。
  • stops:包含取货和送货信息的停止点对象数组,包括位置坐标(纬度和经度)和每个停止点的地址。
  • language:返回报价的语言。此参数是可选的,默认可以设置为 en_US。
  • item:包含有关要交付的物品的信息的对象,包括数量、重量、类别和处理说明。此参数是可选的。

以下是一个创建报价的示例代码片段

$serviceType = $possible_service->key;
$stops = [(object)[
    'coordinates' => (object)[
        'lat' => "-23.6008754",
        'lng' => "-46.6521289"
    ],
    'address' => 'Alameda Anapurus'
], (object)[
    'coordinates' => (object)[
        'lat' => "$location->lat",
        'lng' => "$location->lng",
    ],
    'address' => $package['destination']['address']
]];
$item = (object)[
    "quantity" => "$quantity",
    "weight" => "LESS_THAN_3KG",
    "categories" => ["FOOD_DELIVERY", "OFFICE_ITEM"],
    "handlingInstructions" => ["KEEP_UPRIGHT"]
];
$response = $lalamove_api->quotations($serviceType, $stops, $language, $item);
$quotation = $response->data;