README

本包允许客户端应用程序与MySweezi API集成。

安装

composer install sweezi/php-sdk

入门指南

use Sweezy\SDK\SDK;

SDK::setInstance($url, $clientId, $secret);

clientId 和 secret 是使用注册的令牌进行应用程序认证的凭据。

示例

• 请求所有店铺

$resource = new StoreResource();
$stores = $resource->getAll();

• 创建订单

use Sweezy\SDK\Order\OrderResource;
use Sweezy\SDK\Entity\Address;
use Sweezy\SDK\Entity\CreateCustomerOrder;
use Sweezy\SDK\Entity\Item;

$planResource = new PlanResource();
$services = $planResource->getServices($store->plan->id);

$orderResource = new OrderResource($storeId);
$shippingAddress = $stores[0]->address;
$receiverAddress = new Address("Valdecaballeros", "210", "06689", "Badajoz", "Av. Madrid");

$items = [];
$items[] = new Item(4, 10, 16, "SKU234", 10, 5);

$orderDTO = new CreateCustomerOrder("Afonso Alves", "test@mail.com", $services[0]->id, $receiverAddress, $shippingAddress, $items);

$order = $orderResource->create($orderDTO);

所有方法

店铺

• 获取所有用户店铺

  $resource = new StoreResource();
  $stores = $resource->getAll();

• 获取店铺地址

  $store->address

订单

• 请求所有店铺订单

  $orderResource = new OrderResource($storeId);
  $orders = $orderResource->getAllPaginated(new PaginationParams());

  search、sort、order、startIndex 和 maxResults 的值是可选的。

• 请求一个店铺订单

  $order = $orderResource->getOne($orderId);

• 创建订单

  $orderDTO = new CreateCustomerOrder($contactName, $email, $serviceId, $receiverAddress, $shippingAddress, $items);
  $order = $resource->create($orderDTO);

• 更新订单

  $orderDTO = new CreateCustomerOrder($contactName, $email, $serviceId, $receiverAddress, $shippingAddress, $items);
  $order = $resource->update($order->id, $orderDTO);

• 获取订单跟踪信息

  $tracking = $resource->getTracking($order->id);

其他

• 获取所有国家

  $resource = new CountryResource();
  $countries = $resource->getAll();

• 获取所有计划

  $resource = new PlanResource();
  $plans = $resource->getAll();

• 获取计划的所有服务

  $services = $resource->getServices($plan->id);

• 获取跟踪信息

  $resource = new TrackingResource();
  $trackingData = $resource->getTracking($trackingNumber);

• 获取Sweezi Spots

  $resource = new SweeziSpotResource();
  $spots = $resource->getSweeziSpots($countryCode, $postalCode);