@haatlabs-core/provider-amazon

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptESM + CJS近 30 天下载 5124

亚马逊搜索,产品和建议作为产品源.

中文使用文档
文档目录8 节
  1. 安装
  2. 它会做什么
  3. 选项
  4. 错误
  5. 门户和最后期限
  6. 固定设备
  7. 测试
  8. 托管服务

@haatlabs-core/ 提供者- 亚马逊

@haatlabs-core/provider-amazon/contracts (0.12.1):错误代码 (单位:千美元)PROVIDER_AMAZON_ERRORS),来源的图谋和类型(ProductRefSchema, (中文(简体) ), SourceInfoSchema, (中文(简体) ), ProductSource,市场以及链接和文本帮助: 除此之外,其他的都一样 createAmazonSource没有节点 一个项目的合同,它的页面装入, 从这里导入, 永远不要根, 这是为节点.

安装

pnpm add @haatlabs-core/provider-amazon

它给你的应用程序留下了一个软件包,所以该应用程序持有一个副本: zod。 。 。 .

它会做什么

亚马逊搜索、产品和建议,通过一个亚马逊刮刮机,直接或通过 服务网关 : createAmazonSource(options) 给出一个 ProductSource (单位:千美元)search, (中文(简体) ), product, (中文(简体) ), autocomplete, (中文(简体) ), parseLink, (中文(简体) ), health) (中文(简体) ). 它不会缓存任何信息: 将呼叫包入 cachedCall (@haatlabs-core/提供商) AMAZON_CACHE_SECONDS (搜索和产品一小时, 页:1. AMAZON_IMAGE_HOSTS 是一个内容安全政策名称.

选项

baseUrl (刮发机,网关) /amazon,或主机API), timeoutMs, (中文(简体) ), apiKey (主办方API's)或 gatewayKey (网关;设置两者都是 RangeError, (中文(简体) ), proxyEnabled (日本和澳大利亚需要一个离开那里的代理), fetch, (中文(简体) ), maxConcurrent (12次航班通话), maxWaitMs (10 s) 在呼叫前一个地方 (拒绝)和 maxResponseBytes (2个小米B).

错误

SOURCE_BAD_REQUEST (400个), SOURCE_PRODUCT_NOT_FOUND (404美元,仅用于产品), SOURCE_UNAVAILABLE (503,即瞬间:去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去不去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去去 maxWaitMs和 SOURCE_ERROR (503:无法使用的答案). 项目分布 PROVIDER_AMAZON_ERRORS 输入 defineErrors429或5xx载具 retryAfterMs 从其 重试 - 之后( 秒或日期, 最多5分钟) 。 被直接叫来,拒绝的身体是 从未读过: 连接是松开的 .

门户和最后期限

每一次通话都要有一个 CallContext (级别、优先权、, deadlineMs; 与 gatewayKey 它发出 网关头,第4级,在无网关时。 呼叫的时限是 timeoutMs,或 deadlineMs 在那更早的时候localTimeoutMs),它开始于 等待一个 maxConcurrent 地点:等待很重要,一个时间不多的电话 等待的时候,它永远不会被制造出来。 网关被赋予了这个限度的余下部分,永远不再存在. 截止时间是每个电话的:一个呼叫者重试 重新开始,所以一个呼叫者重试 给每个尝试 剩下的自己的预算。 通过网关,拒绝就意味着 UpstreamStatusError 联合国 原因 : isGatewayRefusal(error) 对网关的401和403都是真实的(两者都是) SOURCE_UNAVAILABLE),只有网关自己的 bad_request 400是一个合同错误.

固定设备

@haatlabs-core/provider-amazon/fixtures数字 : amazonFixtures.product, (中文(简体) ), .search 财务报告和审定财务报表 .autocomplete,从真正的刮刮机记录的答案.

测试

@haatlabs-core/provider-amazon/testing数字 : createFakeSource(options),一秒钟 ProductSource 与一个市场, 测试不能假设亚马逊。 包裹的测试是单位的 固定装置试验: pnpm --filter @haatlabs-core/provider-amazon test。 。 。 .

托管服务

没有自己的刮刮机,请通过RapidAPI上的Haatlabs API读取 Amazon: set haatlabsApiKey (你的快速API键)和 baseUrl: 'https://haatlabs-api.p.rapidapi.com' (单位:千美元)apiKey 财务报告和审定财务报表 gatewayKey 无效)。 每个市场都有,没有 建议autocomplete (a) 拒绝保留其信息 拒绝的密钥是 SOURCE_UNAVAILABLE 这不是短暂的。 见 @haatlabs-core/services 财务报告和审定财务报表 https://haatlabs.shop/docs/服务/

版本与发布记录

@haatlabs-core/provider-amazon 共发布 27 个版本,首次发布于 2026/10/23;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.18.5latest2026/11/143 天前
0.18.42026/11/133 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/provider-amazon 的常见问题

@haatlabs-core/provider-amazon 是什么?

亚马逊搜索,产品和建议作为产品源.

如何安装 @haatlabs-core/provider-amazon?

在项目目录运行 npm install @haatlabs-core/provider-amazon,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.6.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haatlabs-core/provider-amazon 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haatlabs-core/provider-amazon 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@haatlabs-core/provider-amazon 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haatlabs-core/provider-amazon 可以商用吗?

@haatlabs-core/provider-amazon 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/provider-amazon 的下载量有多少?

根据 npm 官方下载统计,@haatlabs-core/provider-amazon 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,124 次,日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haatlabs-core/provider-amazon 还在维护吗?

最新版本 0.18.5 发布于 2026/11/14(3 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。