bricre / amazon-selling-partner-sdk-orders

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

v0 2022-06-26 11:46 UTC

This package is auto-updated.

Last update: 2024-08-26 16:17:53 UTC


README

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

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

请参阅Amazon 的文档以了解详细的 API 行为解释。

安装

composer require bricre/amazon-selling-partner-sdk-orders

您还需要一个基于 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\Orders\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']);

作者