contentful-api

Contentful REST API ガイド

HTTP/curl を使用して Contentful API を操作するための、言語に依存しないガイドです。

共通のリファレンス

• 認証 — トークンの種類、認証ヘッダー、API ベース URL（US/EU）
• HTTP の規約 — バージョンの固定、レート制限、ページネーション、エラー、ロケールの構成

Content Management API（CMA）

コンテンツ、コンテンツタイプ、アセット、環境を管理するための読み書き可能な API です。

まずはこちら: references/content-management/overview.md

• entries.md — CRUD、公開／非公開、バージョン管理、クエリパラメーター
• content-types.md — コンテンツモデル、フィールドタイプ、バリデーションの定義／更新
• assets.md — メディアファイルのアップロード、処理、公開
• environments.md — 環境とエイリアスの作成、複製、管理

Content Delivery API（CDA）

公開済みコンテンツを取得するための読み取り専用 API です。

まずはこちら: references/content-delivery/overview.md

• querying.md — フィルター、検索演算子、ページネーション、並べ替え
• includes-links.md — include パラメーター、リンクの解決
• localization.md — ロケールパラメーター、フォールバックチェーン
• sync.md — コンテンツの差分同期

Content Preview 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}"