# @contentstack/management 中文文档

规范地址：https://npmcn.com/package/%40contentstack/management/

版本：1\.31\.3
npm 元数据更新时间：2026-11-02T10:03:29.494Z
中文译文更新时间：2026-11-10T16:43:18.978Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.9 MB，166 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=8\.0\.0
- 运行依赖：10 个
- 首次发布：2020-09-23T09:15:24.686Z
- 最新版本发布：2026-11-02T10:03:29.168Z
- 近 30 天下载量：154587（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：87（近 12 个月 21 个）

## 中文简介

内容管理 API 用于管理您目录账户的内容

## 安装

```sh
npm install @contentstack/management
```

也可以使用：`pnpm add @contentstack/management`、`yarn add @contentstack/management`、`bun add @contentstack/management`

## README

# 内容夹- 管理- javascript- 变量

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

## 内存管理 JavaScript SDK

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

这个SDK使用 [内容管理 API](https://www.contentstack.com/docs/developers/apis/content-management-api/) (中文(简体) ). CMA 用于管理您“内容”账户的内容。 这包括创建、更新、删除和获取您的账户内容。 要使用 CMA, 您需要使用一个 [管理托肯](https://www.contentstack.com/docs/developers/create-tokens/about-management-tokens) 或一个 [奥托肯语Name](https://www.contentstack.com/docs/developers/apis/content-management-api/#how-to-get-authtoken)。请在 [认证](https://www.contentstack.com/docs/developers/apis/content-management-api/#authentication)。 。 。 .

注:通过使用CMA,您可以执行获取内容的请求。 然而,我们强烈建议你永远使用 [内容交付 API](https://www.contentstack.com/docs/developers/apis/content-delivery-api/) 向您的网络或移动属性发送内容.

### 先决条件

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

### 安装

#### 节点

通过 npm 安装 :

```bash
npm i @contentstack/management
```

要导入 SDK , 请使用下列方法之一 :

1.  **JavaScript ES 模块**
    
    ```javascript
     import contentstack from '@contentstack/management';
    ```
    
    -   要求数 `"type": "module"` 装入包裹
2.  **使用 esModule Interop 的脚本**
    
    ```typescript
     import contentstack from '@contentstack/management';
    ```
    
    -   要求数 `"esModuleInterop": true` 在 tsconfig.json 中输入
3.  **脚本命名空间导入**
    
    ```typescript
     import * as contentstack from '@contentstack/management';
    ```
    
    -   工程,无论 esModule Interop 设置
4.  **类型脚本解构**
    
    ```typescript
     import contentstack from '@contentstack/management';
     const { client } = contentstack;
    ```
    
    -   从默认导出时访问客户端功能

### 认证

要使用此 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 请求 **用户专用** 符号 .

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

### 登录

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

```javascript
contentstackClient.login({ email: 'EMAIL', password: 'PASSWORD'})
.then((response) => {
    console.log(response.notice)
    console.log(response.user)
})
```

### 管理托肯

[管理](https://www.contentstack.com/docs/developers/create-tokens/about-management-tokens/) 为: **堆栈级别** 标志,没有用户附着.

```javascript
contentstackClient.stack({ api_key: 'API_KEY', management_token: 'MANAGEMENT_TOKEN' }).contentType('CONTENT_TYPE_UID')
.fetch()
.then((contenttype) => {
    console.log(contenttype)
})
```

### 主机和区域配置

您可以为 API 请求配置 SDK 以使用特定区域或自定义主机 .

#### 地区

SDK支持多个区域. 有效区域值为: `NA`, (中文(简体) ), `EU`, (中文(简体) ), `AU`, (中文(简体) ), `AZURE_NA`, (中文(简体) ), `AZURE_EU`, (中文(简体) ), `GCP_NA`, (中文(简体) ), `GCP_EU`。默认区域是 `NA`。 。 。 .

```javascript
// Use EU region
contentstackClient = contentstack.client({ 
  authtoken: 'AUTHTOKEN',
  region: 'EU' 
})
```

#### 自定义主机

您可以为 API 请求指定自定义主机 。 如果两者兼有 `host` 财务报告和审定财务报表 `region` 提供 `host` 参数优先.

```javascript
// Use custom host
contentstackClient = contentstack.client({ 
  authtoken: 'AUTHTOKEN',
  host: 'api.contentstack.io' 
})

// Custom host takes priority over region
contentstackClient = contentstack.client({ 
  authtoken: 'AUTHTOKEN',
  region: 'EU',
  host: 'custom-api.example.com' 
})
```

### 内存管理 JavaScript SDK:5分快起步

#### 初始化您的 SDK :

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

```javascript
import contentstack from ‘@contentstack/management’

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

#### 获取堆栈细节

使用下列代码来获取您的堆栈细节 :

```javascript
contentstackClient.stack({ api_key: 'API_KEY' })
.fetch()
.then((stack) => {
    console.log(stack)
})
```

#### 创建条目

要在堆栈的特定内容类型中创建条目,请使用以下行代码:

```javascript
var  entry  = {
    title: 'Sample Entry',
    url: '/sampleEntry'
}

contentstackClient.stack({ api_key: 'API_KEY' }).contentType('CONTENT_TYPE_UID').entry().create({ entry })
.then((entry) => {
    console.log(entry)
})
```

#### 创建资产

下列代码可以用于上传资产到您的堆栈 :

```javascript
var  asset  = {
    upload: 'path/to/file',
    title: 'Asset Title'
}

contentstackClient.stack({ api_key: 'API_KEY' }).asset().create({ asset })
.then((asset) => {
    console.log(asset)
})
```

### 帮助链接

-   [链接网站](https://www.contentstack.com/)
-   [正式文件](https://contentstack.com/docs)
-   [内容管理 API Docs](https://www.contentstack.com/docs/developers/apis/content-management-api)

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

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

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

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

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

## 常见问题

### @contentstack/management 是什么？

内容管理 API 用于管理您目录账户的内容

### 如何安装 @contentstack/management？

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

### @contentstack/management 支持 TypeScript 吗？

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

### @contentstack/management 支持 ESM 还是 CommonJS？

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

### @contentstack/management 需要什么版本的 Node\.js？

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

### @contentstack/management 可以商用吗？

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

### @contentstack/management 的下载量有多少？

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

### @contentstack/management 还在维护吗？

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