# @bizon/amazon-ids 中文文档

规范地址：https://npmcn.com/package/%40bizon/amazon-ids/

版本：6\.0\.0
npm 元数据更新时间：2026-07-31T12:56:51.110Z
中文译文更新时间：2026-11-08T05:16:29.346Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bizon/amazon-ids
原文对照：https://npmcn.com/package/%40bizon/amazon-ids/?lang=original
项目主页：https://github.com/bizon/amazon-ids#readme
源码仓库：https://github.com/bizon/amazon-ids

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：88.9 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2019-07-10T13:53:43.774Z
- 最新版本发布：2026-07-31T12:56:50.765Z
- 近 30 天下载量：2573（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 2 个）

## 中文简介

收集亚马逊标识符

## 安装

```sh
npm install @bizon/amazon-ids
```

也可以使用：`pnpm add @bizon/amazon-ids`、`yarn add @bizon/amazon-ids`、`bun add @bizon/amazon-ids`

## README

# @bizon/amazon-ids (英语)

[![npm version](https://img.shields.io/npm/v/@bizon/amazon-ids)](https://www.npmjs.com/package/@bizon/amazon-ids) [![codecov](https://codecov.io/github/bizon/amazon-ids/graph/badge.svg?token=U6I6anuPfw)](https://codecov.io/github/bizon/amazon-ids) [![XO code style](https://img.shields.io/badge/code_style-xo-cyan)](https://github.com/xojs/xo)

收集亚马逊标识符

[![Bizon](https://files.bizon.solutions/images/logo/bizon-horizontal.png)](https://www.bizon.solutions/?utm_source=github&utm_medium=readme&utm_campaign=amazon-ids)

## 中情局

[![Tests](https://github.com/bizon/amazon-ids/actions/workflows/tests.yml/badge.svg)](https://github.com/bizon/amazon-ids/actions/workflows/tests.yml) [![Release](https://github.com/bizon/amazon-ids/actions/workflows/release.yml/badge.svg)](https://github.com/bizon/amazon-ids/actions/workflows/release.yml)

## 开始

```bash
npm install --save @bizon/amazon-ids
```

## API 密码

所有三种查询功能都超载:通过已知的字元(或输入的值) 包含以下工会之一)返回 a `Marketplace`,同时通过任意 `string` 返回时 `Marketplace | undefined`。 。 。 .

```ts
import {getMarketplaceByCode, type MarketplaceCode} from '@bizon/amazon-ids'

getMarketplaceByCode('fr').domain // Marketplace — no optional chaining needed
getMarketplaceByCode(someString)?.domain // Marketplace | undefined
```

出口工会是 `MarketplaceCode`, (中文(简体) ), `MarketplaceId`, (中文(简体) ), `MarketplaceRegion` 财务报告和审定财务报表 `MarketplaceDomain`。 。 。 . `MarketplaceCode` 财务报告和审定财务报表 `MarketplaceDomain` 只覆盖 亚马逊商店前门服务市场——多渠道(`*-non-amazon`, (中文(简体) ), 发票和亚马逊付费条目没有域名,所以其代码不属于 工会和寻找他们的回报 `Marketplace | undefined`。 。 。 .

### `marketplaces`

```js
import {marketplaces} from '@bizon/amazon-ids'

for (const marketplace of marketplaces) {
  // console.log(marketplace)
}
```

### `getMarketplaceById(id)`

```js
import {getMarketplaceById} from '@bizon/amazon-ids'

getMarketplaceById('ATVPDKIKX0DER')

/*
{
  code: 'us',
  id: 'ATVPDKIKX0DER',
  name: 'United States',
  region: 'na',
  domain: 'amazon.com',
  advertisingApiDomain: 'advertising-api.amazon.com',
  imagesDomain: 'images-na.ssl-images-amazon.com',
  vendorId: 'ATVPDKIKX0DER',
  sellerCentralDomain: 'sellercentral.amazon.com',
  vendorCentralDomain: 'vendorcentral.amazon.com',
  currencyCode: 'USD'
}
*/
```

也有可能找到多渠道市场:

```js
getMarketplaceById('A2ZV50J4W1RKNI')

/*
{
  code: 'us-non-amazon',
  id: 'A2ZV50J4W1RKNI',
  name: 'United States - Non-Amazon',
  region: 'na',
  currencyCode: 'USD'
}
*/
```

### `getMarketplaceByCode(code)`

```js
import {getMarketplaceByCode} from '@bizon/amazon-ids'

getMarketplaceByCode('DE')

/*
{
  code: 'de',
  id: 'A1PA6795UKMFR9',
  name: 'Germany',
  region: 'eu',
  domain: 'amazon.de',
  advertisingApiDomain: 'advertising-api-eu.amazon.com',
  imagesDomain: 'images-eu.ssl-images-amazon.com',
  vendorId: 'A3JWKAKR8XB7XF',
  sellerCentralDomain: 'sellercentral-europe.amazon.com',
  vendorCentralDomain: 'vendorcentral.amazon.de',
  currencyCode: 'EUR'
}
*/
```

### `getMarketplaceByDomain(domain)`

```js
import {getMarketplaceByDomain} from '@bizon/amazon-ids'

getMarketplaceByDomain('Amazon.com.mx')

/*
{
  code: 'mx',
  id: 'A1AM78C64UM0Y8',
  name: 'Mexico',
  region: 'na',
  domain: 'amazon.com.mx',
  imagesDomain: 'images-na.ssl-images-amazon.com',
  vendorId: 'AVDBXBAVVSXLQ',
  sellerCentralDomain: 'sellercentral.amazon.com.mx',
  vendorCentralDomain: 'vendorcentral.amazon.com.mx',
  currencyCode: 'MXN'
}
*/
```

## 许可证

麻省理工学院

## 杂项

```text
    ╚⊙ ⊙╝
  ╚═(███)═╝
 ╚═(███)═╝
╚═(███)═╝
 ╚═(███)═╝
  ╚═(███)═╝
   ╚═(███)═╝
```

## 常见问题

### @bizon/amazon-ids 是什么？

收集亚马逊标识符

### 如何安装 @bizon/amazon-ids？

在项目目录运行 npm install @bizon/amazon-ids，或使用 pnpm add / yarn add / bun add。

### @bizon/amazon-ids 支持 TypeScript 吗？

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

### @bizon/amazon-ids 支持 ESM 还是 CommonJS？

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

### @bizon/amazon-ids 可以商用吗？

@bizon/amazon-ids 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bizon/amazon-ids 的下载量有多少？

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

### @bizon/amazon-ids 还在维护吗？

最新版本 6\.0\.0 发布于 2026/07/31（3 个月前）；至今共发布 46 个版本，其中过去 12 个月发布了 2 个；首次发布于 2019/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。