cloudprinter/cloudcore

这是一个帮助开发者轻松集成CloudPrinter CloudCore API的库。

v1.0.15 2022-09-07 11:15 UTC

This package is auto-updated.

Last update: 2024-09-07 15:18:02 UTC


README

Cloudprinter.com PHP SDK 是一个具有实用功能的库,使PHP开发者能够轻松将他们的平台与Cloudprinter.com集成,并向我们的CloudCore API发送请求和帖子。此PHP SDK使得设置集成以请求即时定价、发布打印订单、获取生产信号等功能变得简单。

CloudCore API 被设计成易于与任何应用程序或服务集成。

我们在Cloudprinter.com已连接150多台打印机,几乎可以在世界上的任何国家打印和发货打印产品。无论这是在附近还是在世界另一端,我们都已为您做好准备:我们目前可以在100多个国家提供500多种产品。

我们的平台利用智能路由算法将任何打印作业路由到最接近和最合格的打印机。基于位置、性能、价格和生产选项,这些算法将这些打印作业路由到您配送地址附近的最近印刷设施,以帮助您节省运输时间和成本。

访问我们的网站,了解我们提供的所有产品和服务的更多信息。

完整文档

点击链接阅读完整文档。

安装

CloudCore SDK 可以通过Composer安装。运行以下命令

composer require cloudprinter/cloudcore

先决条件

  • composer(用于安装)
  • PHP 7.0或更高版本
  • 必须启用json、fileinfo扩展
  • Cloudprinter.com 打印API账号

身份验证

身份验证通过预定义的CloudCore API密钥完成。CloudCore API密钥位于Cloudprinter.com 控制台

示例

获取订单列表。

use CloudPrinter\CloudCore\Client\CloudCoreClient;

$apiKey = '***';

$client = new CloudCoreClient($apiKey);
$response = $client->order->getList();

print_r($response->getData());

创建新订单。

use CloudPrinter\CloudCore\Client\CloudCoreClient;
use CloudPrinter\CloudCore\Exception\ValidationException;
use CloudPrinter\CloudCore\Model\{Address, File, OrderItem, Order, Option};

$apiKey = '***';
$client = new CloudCoreClient($apiKey);

$address = new Address();
$address->setEmail('test@mail.com')
    ->setFirstName('John')
    ->setLastName('Doe')
    ->setCountry('NL')
    ->setCity('Amsterdam')
    ->setStreet('Street1')
    ->setPhone('+31-655-538-848')
    ->setZip('1071 JA')
    ->setType('delivery');

$fileCover = new File();
$fileCover->setUrl('https://s3-eu-west-1.amazonaws.com/demo.cloudprinter.com/b52f510a5e2419f67c4925153ec0c080_v2/CP_Sample_doc_A4_Book_Cover_Textbook_80_gsm_Casewrap_v2.1.pdf')
    ->setType('cover');

$fileBook = new File();
$fileBook->setUrl('https://s3-eu-west-1.amazonaws.com/demo.cloudprinter.com/b52f510a5e2419f67c4925153ec0c080_v2/CP_Sample_doc_A4_Book_Interior_Textbook_v2.1.pdf')
    ->setType('book');

$item = new OrderItem();
$item->setReference('item-1')
    ->setCount(1)
    ->setProduct('textbook_cw_a4_p_bw')
    ->setShippingLevel('cp_saver')
    ->addFile($fileCover)
    ->addFile($fileBook)
    ->addOption(new Option('cover_finish_gloss', 1))
    ->addOption(new Option('pageblock_80off', 1))
    ->addOption(new Option('cover_130mcg', 1))
    ->addOption(new Option('total_pages', 100));

$order = new Order();
$order
    ->setEmail('test@mail.com')
    ->setReference('sdk-' . time())
    ->addItem($item)
    ->addAddress($address);

try {
    $response = $client->order->create($order);
    print_r($response->getData());
} catch (ValidationException $e) {
    print_r($e->getValidationMessages());
}

了解更多信息

点击链接阅读完整文档。