cyrrill/apai-io

Amazon 产品推广 PHP 库

2.0.0 2017-07-11 06:24 UTC

README

Scrutinizer Code Quality Code Coverage Build Status Latest Stable Version Total Downloads Build Status Documentation Status

ApaiIO 是一个高度灵活的 PHP 库,用于通过 REST 或 SOAP 获取产品推广 API。您可以使用内置操作,如 ItemSearch 或 ItemLookup,或者实现您自己的操作以适应您的需求。

所有代码都是针对接口编写的,因此您可以实现自己的请求或响应类,例如。

此类由 Amazon WS Front 的产品推广 API(前身为 ECS)实现。 https://affiliate-program.amazon.com/gp/advertising/api/detail/main.html

您可以使用新的演示网站进行尝试: http://apaiio.dev.pixel-web.org/

注意:这是一个由 cyrrill 维护的带有附加功能的分支,由于它与原始源代码在功能上有很大差异,它具有不同的 composer 处理器。它不被期望合并到主线中,但在可用时将接收上游更新。

文档

文档目前正在建设中。

您可以在以下链接中阅读: http://apai-io.readthedocs.io/en/latest/

安装

Composer

在您的 composer.json 中添加 apai-io,或者创建一个新的 composer.json 文件

{
    "require": {
        "cyrrill/apai-io": "~2.0"
    }
}

现在运行以下命令让 composer 下载库

$ php composer.phar install

Composer 将自动生成自动加载器文件。因此,您只需要包含此文件。通常它位于 vendor 目录中,并命名为 autoload.php

基本用法

此库使用 PSR-0 标准: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md 因此您可以使用任何符合此标准的自动加载器。测试目录包含一个示例引导文件。

<?php
namespace Acme\Demo;

use ApaiIO\Configuration\GenericConfiguration;
use ApaiIO\Operations\Search;
use ApaiIO\ApaiIO;

$conf = new GenericConfiguration();
$client = new \GuzzleHttp\Client();
$request = new \ApaiIO\Request\GuzzleRequest($client);

$conf
    ->setCountry('com')
    ->setAccessKey(AWS_API_KEY)
    ->setSecretKey(AWS_API_SECRET_KEY)
    ->setAssociateTag(AWS_ASSOCIATE_TAG)
    ->setRequest($request);
$apaiIO = new ApaiIO($conf);

$search = new Search();
$search->setCategory('DVD');
$search->setActor('Bruce Willis');
$search->setKeywords('Die Hard');

$formattedResponse = $apaiIO->runOperation($search);

var_dump($formattedResponse);

有关一些非常简单的示例,请访问 samples 文件夹并查看示例文件。这些文件包含构建查询所需的所有信息。

Web 服务文档

托管在 Amazon.com 上: http://docs.amazonwebservices.com/AWSECommerceService/latest/DG/