# @contentstack/marketplace-sdk 中文文档

规范地址：https://npmcn.com/package/%40contentstack/marketplace-sdk/

版本：1\.5\.4
npm 元数据更新时间：2026-06-29T11:03:23.316Z
中文译文更新时间：2026-11-10T16:46:28.803Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.5 MB，79 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2023-10-18T10:28:07.451Z
- 最新版本发布：2026-06-29T11:03:23.174Z
- 近 30 天下载量：49302（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 7 个）

## 中文简介

Contentack Marketplace SDK 用于管理您的 Contentack 市场应用的内容

## 安装

```sh
npm install @contentstack/marketplace-sdk
```

也可以使用：`pnpm add @contentstack/marketplace-sdk`、`yarn add @contentstack/marketplace-sdk`、`bun add @contentstack/marketplace-sdk`

## README

[![Contentstack](https://www.contentstack.com/docs/static/images/contentstack.png)](https://www.contentstack.com/)

## 市场 SDK

内容tack是一种无头的CMS,采用API-First方法. 这是一个CMS,开发者可以用来用他们最喜爱的语言来构建强大的跨平台应用程序. 你只需要建立你的应用程序前端,而Contack会照顾其余的. [更多信息](https://www.contentstack.com/)。 。 。 .

新的Contaltack Marketplace是满足您所有整合要求的一站式商店. 在那里你会找到预建的应用程序,起动器,教程,以及你需要的创建一个完全定制的数字体验堆. 这个SDK有助于管理市场相关业务.

### 先决条件

您需要安装在您的机器上的 Node.js 版本 10 或以上 才能使用 Contentack Marketplace SDK .

### 安装

#### 节点

通过 npm 安装 :

```bash
npm i @contentstack/marketplace-sdk
```

要导入 SDK, 请使用以下命令 :

```
import contentstack from ‘@contentstack/marketplace-sdk’

contentstackClient = contentstack.client()
```

### 认证

要使用此 SDK, 您需要使用 Authtoken, certain, 或 Management Token( stack- level sord) 认证您的用户 .

### 奥托肯语Name

一个 [奥托肯语Name](https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens/#authentication-tokens-authtokens-) 是一个读写符,用来发出授权的 CMA 请求 **用户专用** 符号 .

```
contentstackClient = contentstack.client({ authtoken: 'AUTHTOKEN' })
```

### 登录

要通过使用证书登录到Controltack,您可以使用以下代码行 :

```
contentstackClient.login({ email: 'EMAIL', password: 'PASSWORD'})
```

### OAuth 托肯语Name

[内容存储 OAuth](https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth) 使用 OAuth 2.0 协议,允许外部应用程序和服务代表用户访问Contextack API.

```
contentstackClient = contentstack.client({ authorization: 'OAUTH_TOKEN' })
```

### 内容tack 市场 SDK:5分钟快起

#### 初始化您的 SDK :

要使用"市场"SDK,需要先初始化. 要做到这一点,请使用以下代码:

```
import contentstack from ‘@contentstack/marketplace-sdk’

const contentstackClient = contentstack.client({ authtoken: 'AUTHTOKEN' })
```

#### 查找全部选址应用程序

要获取您Contentack组织中所有应用程序的细节, 请执行以下代码 :

```
import * as contentstack from '@contentstack/marketplace-sdk'

const client = contentstack.client({ authtoken: 'TOKEN'})

client.marketplace('organization_uid')
    .findAllApps()
    .then((collection) => {
        console.log(collection)
    })
```

#### 获取单个应用程序细节

要获取特定应用程序的细节, 请执行以下代码 :

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'})

client.marketplace('organization_uid')
    .app('manifest_uid')
    .fetch()
    .then((app) => console.log(app))
```

#### 创建新应用程序

要在您的 Contentack 组织中创建新的应用程序/功能, 请执行以下代码 :

```
import * as contentstack from '@contentstack/marketplace-sdk'
const client = contentstack.client({ authtoken: 'TOKEN'})
const app = {
 name: 'APP_NAME',
 description: 'APP_DESCRIPTION',
 target_type: 'stack'/'organization',
 webhook: // optional
  {
    target_url: 'TARGET_URL',
    channel: 'CHANNEL'
  },
 oauth: // optional
  {
    redirect_uri: 'REDIRECT_URI',
    enabled: true,
  }
}

client.marketplace('organization_uid')
    .app()
    .create(app)
    .then((app) => console.log(app))
```

### 帮助链接

-   [链接网站](https://www.contentstack.com/)
-   [正式文件](https://contentstack.com/docs)
-   [关于Contack 市场](https://www.contentstack.com/docs/developers/marketplace-platform-guides/about-marketplace)

### 《麻省理工学院许可证》

版权所有:2012-2024年 [目录](https://www.contentstack.com/)保留的所有权利d

特此准许任何人免费获得本软件和相关文件文件("软件")的副本,不受限制地在软件中进行交易,包括不受限制地享有软件的使用、复制、修改、合并、出版、分发、分版和(或)销售的权利,并允许软件获得者这样做,但须符合下列条件: 1

上述版权通知和许可通知应载入软件的所有副本或大部分.

软件是提供的"AS IS", 没有任何种类的恐惧, 释放或被卷入, 包括但不限制在 危机的保障, 证明一个特定的目的和无关。 任何索赔、索赔或其他负债,无论是合同、交易或其他行为,产生于、产生于或涉及软件或软件的使用或其他交易的行为,都不得作为担保.

## 常见问题

### @contentstack/marketplace-sdk 是什么？

Contentack Marketplace SDK 用于管理您的 Contentack 市场应用的内容

### 如何安装 @contentstack/marketplace-sdk？

在项目目录运行 npm install @contentstack/marketplace-sdk，或使用 pnpm add / yarn add / bun add。

### @contentstack/marketplace-sdk 支持 TypeScript 吗？

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

### @contentstack/marketplace-sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @contentstack/marketplace-sdk 可以商用吗？

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

### @contentstack/marketplace-sdk 的下载量有多少？

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

### @contentstack/marketplace-sdk 还在维护吗？

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