bricre/amazon-selling-partner-sdk-merchant-fulfillment
由 Amazon Selling Partner API for Merchant Fulfillment 的 OpenAPI 定义生成的 API 客户端
v0
2021-09-23 22:19 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-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']);
作者
- Allan Sun - 初始工作