bricre / amazon-selling-partner-sdk-catalog-items
由 Amazon Selling Partner API 的 Catalog Items OpenAPI 定义生成的 API 客户端
2020.12.01
2021-09-23 22:20 UTC
Requires
- allansun/openapi-runtime: ^2.1
Requires (Dev)
- allansun/openapi-code-generator: ^0.2.5
- allansun/openapi-parser: ^2.1.4
This package is auto-updated.
Last update: 2024-09-14 15:27:16 UTC
README
使用 Amazon 的 Swagger 文件通过 allansun/openapi-code-generator 生成的代码。
生成的代码具有良好的自文档,带有适当的 PHPDoc 注释。
有关详细的 API 行为解释,请参阅 Amazon 的文档。
安装
composer require bricre/amazon-selling-partner-sdk-catalog-items
您还需要一个基于 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\CatalogItems\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']);
作者
- Allan Sun - 初始工作