bricre/amazon-selling-partner-sdk-merchant-fulfillment

由 Amazon Selling Partner API for Merchant Fulfillment 的 OpenAPI 定义生成的 API 客户端

v0 2021-09-23 22:19 UTC

This package is auto-updated.

Last update: 2024-09-24 04:55:00 UTC


README

使用 Amazon 的 Swagger 文件通过 allansun/openapi-code-generator 生成的代码。

生成的代码具有良好的自文档,带有正确的 PHPDoc 注释。

请参考 Amazon 的文档 了解 API 行为的详细说明。

安装

composer require bricre/amazon-selling-partner-sdk-merchant-fulfillment

您还需要一个基于 PSR-7 的客户端或 Symfony 的 HTTP Foundation 基于的客户端

所以您可以选择 Guzzle(或其他 PSR-7 兼容的客户端)

composer require guzzlehttp/guzzle

或者 Symfony HTTP 客户端

composer require symfony/http-client

版本控制

此项目与 Amazon 的 API 版本控制相匹配。

由于 Composer 的限制,版本号如 '2021-01-01' 将更改为 '2021.01.01'。

如果您发现没有可用的匹配版本,请联系作者以生成针对正确版本的代码。

用法

首先您需要配置 OpenAPI\RunTime\Client,包括所需的凭证和预定义的响应类型。您只需这样做一次(或创建一个服务在您的依赖注入中)。

您还可能想查看 Amazon 关于 如何授权您的请求 的文档。

<?php
use Amz\MerchantFulfillment\ResponseTypes;
use OpenAPI\Runtime\Client;
use OpenAPI\Runtime\SimplePsrResponseHandlerStack;

Client::configure(
    new \GuzzleHttp\Client([
        'base_uri' => 'https://sellingpartnerapi-na.amazon.com/',
        'headers'=>[
            'Authorization'=> 'Bearer <accessToken>'
        ]
    ]),
    new SimplePsrResponseHandlerStack(new ResponseTypes())
);

然后在您的业务逻辑中,您可以直接调用 API 操作

<?php
use Amz\AplusContent\Api\AplusContent;
use Ebay\Sell\Account\Api\Program;

$api = new AplusContent();

$docs = $api->searchContentDocuments(['marketplaceId'=>'xxxxxx']);

作者