mcpField
C
contentful-api

contentful-api

github.com/contentful开发39391 次安装1 天前更新
代码仓库

关于 contentful-api

contentful-api 是使用 HTTP 和 curl 调用 Contentful API 的跨语言指南，面向管理内容或获取已发布及预览内容的开发者，涵盖 REST、图片和 GraphQL API 参考资料。

主要功能

  1. 01内容管理 API 参考
  2. 02内容交付与预览指南
  3. 03内容类型、条目、资源与环境管理
  4. 04查询、本地化与同步
  5. 05图片与 GraphQL API 参考

适用场景

  1. 01创建并发布 Contentful 条目
  2. 02定义或更新内容模型
  3. 03获取本地化的已发布内容
  4. 04通过 URL 参数转换图片

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/contentful/skills --skill contentful-api

安装后在 Claude Code 中输入/contentful-api确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

package.json
references/
authentication.md
http-conventions.md
references/content-delivery/
includes-links.md
localization.md
overview.md
querying.md
sync.md
references/content-management/
assets.md
bulk-actions.md
content-types.md
entries.md
environments.md
overview.md
references/content-preview/
overview.md
references/graphql/
overview.md
references/images/
overview.md

详细介绍

Contentful REST API 指南

使用 HTTP/curl 调用 Contentful API 的语言无关指南。

共享参考

  • 身份验证 — 令牌类型、身份验证标头、API 基础 URL（美国/欧盟）
  • HTTP 约定 — 版本锁定、速率限制、分页、错误、区域设置结构

内容管理 API（CMA）

用于管理内容、内容类型、资源和环境的读写 API。

从这里开始：references/content-management/overview.md

  • entries.md — CRUD、发布/取消发布、版本控制、查询参数
  • content-types.md — 定义/更新内容模型、字段类型、验证规则
  • assets.md — 上传、处理、发布媒体文件
  • environments.md — 创建、克隆和管理环境及别名

内容交付 API（CDA）

用于获取已发布内容的只读 API。

从这里开始：references/content-delivery/overview.md

内容预览 API

通过相同的 CDA 端点提供草稿和已发布内容，但使用不同的主机/令牌。

参考：references/content-preview/overview.md

Images API

通过 URL 参数即时转换图像。无需身份验证。

参考：references/images/overview.md

GraphQL API

使用 CDA 令牌通过 GraphQL 查询内容。

参考：references/graphql/overview.md

快速参考

# CMA: Create a draft entry
curl -X POST https://api.contentful.com/spaces/{space_id}/environments/{env_id}/entries \
  -H "Authorization: Bearer {cma_token}" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -H "X-Contentful-Content-Type: blogPost" \
  -d '{"fields":{"title":{"en-US":"Hello"}}}'
# Then publish: PUT .../entries/{id}/published with X-Contentful-Version header

# CDA: Fetch entries
curl "https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/entries?content_type=blogPost" \
  -H "Authorization: Bearer {cda_token}"

评论

支持 Markdown