如何在amz-sp-api gem中访问并构建指定模型子gem？

一、构建vendor-direct-fulfillment-orders-api-model子gem #

• 该gem基于OpenAPI规范自动生成子gem，先找到vendor-direct-fulfillment-orders对应的OpenAPI spec文件（可在亚马逊SP-API官方文档中获取）。
• 克隆amz_sp_api仓库到本地：git clone https://github.com/ericcj/amz_sp_api.git
• 进入仓库根目录，执行生成命令：bundle exec rake generate[vendor-direct-fulfillment-orders]（需确认API名称与spec文件名匹配），生成的子gem代码会放在gens目录下。
• 进入子gem目录，执行gem build vendor-direct-fulfillment-orders-api-model.gemspec构建gem包，再通过gem install ./vendor-direct-fulfillment-orders-api-model-<版本号>.gem完成本地安装。

二、解决MissingAuthenticationToken错误 #

• 初始化客户端时必须传入完整的认证参数，示例代码：

client = AmzSpApi::VendorDirectFulfillmentOrders::Client.new(
  refresh_token: '你的刷新令牌',
  client_id: '你的SP-APP客户端ID',
  client_secret: '你的SP-APP客户端密钥',
  aws_access_key_id: 'AWS访问密钥ID',
  aws_secret_access_key: 'AWS秘密访问密钥',
  region: 'us-east-1' # 根据实际运营区域调整
)

• 确认SP-APP已申请vendor-direct-fulfillment-orders相关权限，且refresh_token是通过合法授权流程获取的，避免令牌过期或权限不足。

三、查找API用法资料 #

• 生成的子gem目录内包含README.md，其中有基础调用示例和API方法说明，可直接参考。
• 主gem的Getting Started文档中的认证、客户端初始化逻辑适用于所有子gem，只需替换对应客户端类即可。
• 对照亚马逊SP-API官方文档的vendor-direct-fulfillment-orders章节，了解端点参数、返回结构后，对应子gem的方法进行调用。

内容的提问来源于stack exchange，提问作者Daniel Bradley