@contentstack/management

中文文档
1.31.3发布于 2026/11/02MITTypeScriptCommonJS构建来源已验证近 30 天下载 15.5万

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

中文使用文档
文档目录11 节
  1. 内存管理 JavaScript SDK
  2. 先决条件
  3. 安装
  4. 认证
  5. 奥托肯语Name
  6. 登录
  7. 管理托肯
  8. 主机和区域配置
  9. 内存管理 JavaScript SDK:5分快起步
  10. 帮助链接
  11. 《麻省理工学院许可证》

内容夹- 管理- javascript- 变量

Contentstack

内存管理 JavaScript SDK

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

这个SDK使用 内容管理 API (中文(简体) ). CMA 用于管理您“内容”账户的内容。 这包括创建、更新、删除和获取您的账户内容。 要使用 CMA, 您需要使用一个 管理托肯 或一个 奥托肯语Name。请在 认证。 。 。 .

注:通过使用CMA,您可以执行获取内容的请求。 然而,我们强烈建议你永远使用 内容交付 API 向您的网络或移动属性发送内容.

先决条件

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

安装

节点

通过 npm 安装 :

npm i @contentstack/management

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

  1. JavaScript ES 模块

     import contentstack from '@contentstack/management';
    
    • 要求数 "type": "module" 装入包裹
  2. 使用 esModule Interop 的脚本

     import contentstack from '@contentstack/management';
    
    • 要求数 "esModuleInterop": true 在 tsconfig.json 中输入
  3. 脚本命名空间导入

     import * as contentstack from '@contentstack/management';
    
    • 工程,无论 esModule Interop 设置
  4. 类型脚本解构

     import contentstack from '@contentstack/management';
     const { client } = contentstack;
    
    • 从默认导出时访问客户端功能

认证

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

奥托肯语Name

一个 奥托肯语Name 是一个读写符,用来发出授权的 CMA 请求 用户专用 符号 .

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

登录

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

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

管理托肯

管理 为: 堆栈级别 标志,没有用户附着.

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。 。 。 .

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

自定义主机

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

// 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,需要先初始化. 要做到这一点,请使用以下代码:

import contentstack from ‘@contentstack/management’

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

获取堆栈细节

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

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

创建条目

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

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)
})

创建资产

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

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

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

《麻省理工学院许可证》

版权:"2012-2026" 目录保留的所有权利d

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

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

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

版本与发布记录

@contentstack/management 共发布 87 个版本,首次发布于 2020/09/23;过去 12 个月发布了 21 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.31.3latest2026/11/028 天前
1.31.22026/10/061 个月前
1.31.12026/08/033 个月前
1.31.02026/07/293 个月前
1.30.42026/06/294 个月前
1.30.32026/05/255 个月前

关于 @contentstack/management 的常见问题

@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 和提交记录判断。