lojametastore / borzodelivery-php
用于与Borzo Delivery集成的API客户端
dev-main
2022-07-21 18:54 UTC
Requires
- php: >= 7.4
- guzzlehttp/guzzle: ^7.4
Requires (Dev)
- fakerphp/faker: ^1.19
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2024-09-21 23:45:46 UTC
README
API文档
https://borzodelivery.com/br/business-api/doc
需求
- PHP >= 7.4
开始使用
安装
使用Composer安装包
composer require lojametastore/borzodelivery-sdk-php
认证
以下示例展示了如何创建一个带有认证的实例
use BorzoDelivery\Api\Borzo; $borzo = new Borzo('SECRET_AUTH_TOKEN');
可用方法
订单价格计算
订单的计算价格方法用于模拟一个或多个点之间的配送价格。所有可用的请求参数可以在https://borzodelivery.com/br/business-api/doc#calculate-order中查看
$points = new Points(); $points->add([ "address" => 'Address 1', "contact_person" => new ContactPerson([ 'name' => 'Jem', 'phone' => '+1-202-555-0171' ]), "is_order_payment_here" => true, ]); $points->add([ "address" =>'Address 2', "contact_person" => new ContactPerson([ 'name' => 'Polly', 'phone' => '+1-202-555-0172' ]), "client_order_id" => $this->faker()->randomDigit(), "is_order_payment_here" => false, ]); $orderRequest = new Order([ "type" => Order::ORDER_TYPE_STANDARD, "matter" => 'Buys', "vehicle_type_id" => Order::VEHICLE_TYPE_MOTORBIKE, "total_weight_kg" => 5, "insurance_amount" => 150, "points" => $points, ]); $borzo->priceCalculation($order);
执行单元测试
要执行单元测试,您需要设置一个名为SECRET_AUTH_TOKEN
的环境变量
异常
当请求返回任何失败时,将触发一个具有类BorzoDelivery\Exceptions\ApiException
的异常。您可以使用以下示例简单地捕获这个异常
use BorzoDelivery\Exceptions\ApiException; try{ $borzo->priceCalculation($order); } catch (ApiException $apiException) { $errors = $apiException->getErrors(); $warnings = $apiException->getWarnings(); $parametersWarnings = $apiException->getparametersWarnings(); }