README

这是一个社区项目，而非官方项目

这是pick.sa服务的API客户端。pick.sa。这是一个非官方

要求与安装

需要PHP 7.0+

通过Composer

$ composer require yemenifree/pick-service-api

入门指南

设置api服务。

$service = new PickService('Live Token');

您可以通过在第二个参数中传递true来启用沙箱环境。

$sandBoxService = new PickService('Sandbox Token', true);

创建新请求。

您可以通过以下方式创建新请求

$result = $service->request('service', 'action', ...$arg);

检查响应

要检查响应结果，请使用isSeccess()方法。

// check if request seccess.
if (!$result->isSuccess()) {
    // there are error
    $error = $result->json();
}

// All right.
$invoice = $result->json();     

订单。

创建订单

// create Order
$order = new Order();
// set up order info.
$order->setItems(Order::ITEM_HOUSEHOLD)
    ->setPrice(200)
    ->setPickupTime(Carbon::now()->addDays(1))
    ->setPaymentType(Order::PAYMENT_PRE_PAID)
    ->setPickupLocation(24.697168165551115, 46.70957565307617)
    ->setReceiverName('Salah Alkhwlani')
    ->setReceiverPhone('966500484350');

// send create request.
$result = $service->request('orders', 'create', $order);

// check if request seccess.
if (!$result->isSuccess()) {
    $error = $result->json();
}

// All right.
$invoice = $result->json();     

删除订单。

$orderID = 1;
$result = $service->request('orders', 'delete', $orderID);

查看订单。

$orderID = 1;
$result = $service->request('orders', 'view', $orderID);

在订单中搜索。

$query = 'keyword';
$order = '';
$result = $service->request('orders', 'search', $query, $order);

编辑订单。

$orderID = 1;
$orderModel = new Order();
// set up new order info.
$orderModel->setItems(Order::ITEM_HOUSEHOLD)
    ->setPrice(210)
    ->setPickupTime(Carbon::now()->addDays(1))
    ->setPaymentType(Order::PAYMENT_PRE_PAID)
    ->setPickupLocation(24.697168165551115, 46.70957565307617)
    ->setReceiverName('Salah Alkhwlani')
    ->setReceiverPhone('966500484350');

$result = $service->request('orders', 'edit', $orderID, $orderModel);

取消订单。

$result = $service->request('orders', 'cancel', $orderID,$orderModel);

待办事项

• 实现其他服务。
• 为Laravel添加服务提供商和配置。
• 编写单元测试。

变更日志

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

贡献

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

安全

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

鸣谢

• Salah Alkhwlani
• 所有贡献者

许可

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