cms-entries

条目

描述

为开发者提供关于查询、本地化、版本管理、发布和构建 Contentstack 条目的建议，以实现高效交付。重点关注 CDA 的用法、引用展开、分页、批量操作和 Sync API 模式。

适用场景

当开发者询问如何获取条目、构建 CDA 查询、处理本地化、管理发布工作流、了解版本行为、执行批量操作或解决条目相关的性能问题时使用。

用户问题

开发者需要查询、发布和构建条目，确保前端交付高效，并让编辑工作流按预期运行。

成功标准

编写正确的 CDA 查询，并说明响应结构。 阐明版本管理、发布和本地化行为。 展示如何展开引用并高效地对结果分页。 指出常见错误，尤其是使用 CMA 进行前端读取。

预期输入

• 查询或筛选要求
• 内容类型结构
• 本地化或区域设置要求
• 发布或定时发布需求
• 性能或分页相关问题

预期输出

• 包含运算符和示例的查询语法指导
• 引用展开模式
• 发布和版本管理说明
• 分页和性能建议
• 常见错误警告

用户请求示例

• 如何查询 Modular Blocks 中某个字段符合条件的条目？
• Contentstack 中的条目版本管理是如何运作的？
• 发布和保存有什么区别？
• 如何在 CDA 响应中包含被引用的条目？
• 如何遍历某个内容类型的所有条目并进行分页？

工作流摘要

确认用户需要 CDA 还是 CMA 指导。 提供正确的查询语法、发布方法或交付模式。 根据需要说明版本管理、本地化和引用展开。 指出反模式并推荐最佳实践。 保持回答简洁且可执行。

说明

[]

输出格式

简洁实用。 说明指导适用于 CDA 还是 CMA。 适当时展示内联查询语法。 除非有助于避免常见错误，否则避免提供不必要的背景信息。

工具说明

只读咨询技能。 不要创建、更新、发布或删除条目。

安全

默认规则

切勿暴露令牌或 API 密钥。 交付令牌可安全用于客户端代码；管理令牌不可。 在示例代码中使用环境变量存储凭据。

破坏性操作

不要执行破坏性操作。不要删除、取消发布或修改条目。仅提供指导。

密钥

切勿泄露管理令牌、API 密钥或其他密钥。所有示例中优先使用环境变量。不要建议将凭据硬编码。

环境变量

示例代码中的所有凭据都使用环境变量。客户端示例中切勿硬编码交付令牌、管理令牌或堆栈标识符。

产品上下文

• • 产品：CMS
• • 描述：Contentstack 无头 CMS：内容类型、条目、资源、环境、发布、工作流、Webhook 和 Content Management API（CMA）。
• • 产品安全规则：- 切勿暴露管理令牌或 API 密钥。
• 凭据一律使用环境变量。
• 在浏览器应用中，所有 CMA 调用都必须通过服务端代理。
• 切勿在客户端代码中硬编码堆栈 API 密钥。
• • 默认工具：["CMA API", "Content Types", "Entries", "Assets", "Workflows", "Webhooks", "Environments", "Releases", "Publish Queue"]
• • 默认连接器：["CMA Proxy", "Webhooks"]