--- updatedAt: 2026-05-01T04:21:27.000Z agentTools: projectIndex: https://developers.karte.io/llms.txt --- # Get contents CMSで公開したコンテンツ一覧を取得します。 #### APIエンドポイント `{subdomain}` にはプロジェクト固有の値が入ります。KARTE管理画面の「CMS設定」>「APIエンドポイント」で確認できます。 ⚠️ **注意**: Base URLの`{subdomain}`を編集しても、API Requestのコード例には反映されません。Shell/Node/Ruby等のExampleは反映されるのでそちらを使うか、API Requestを利用する場合は`devKarte.server()`で実際のエンドポイントURLを指定してください。 #### Required Scope APIの実行に必要なScopeです。 ``` beta.cdn.cms.content.list ``` #### Required Role 管理画面でScopeを追加する際に必要な権限です。 ``` Craft > Craft 設定の編集 ``` #### レート制限 プロジェクトごとに、1秒あたり80回まで（キャッシュされていないリクエストのみ）です。CDN API・Preview API は別々に数え、一覧取得と単体取得は合算します。超えると `429 Too Many Requests` を返します。`Retry-After` ヘッダーの秒数だけ待ってから再度リクエストしてください。 # OpenAPI definition ````json { "openapi": "3.0.0", "info": { "title": "CMS CDN", "version": "2.0.0" }, "tags": [ { "name": "CDN", "description": "CDN related operations" } ], "x-explorer-enabled": false, "servers": [ { "url": "https://{subdomain}.cdn-api.karte.io", "description": "Production CDN API server", "variables": { "subdomain": { "description": "Project specific subdomain", "default": "your-project-subdomain" } } } ], "components": { "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer" } }, "schemas": { "karteError": { "type": "object", "properties": { "error": { "type": "string", "example": "The request was invalid." } }, "required": [ "error" ] } } }, "paths": { "/beta/cms/content/list": { "get": { "description": "\n CMSで公開したコンテンツ一覧を取得します。\n\n #### APIエンドポイント\n `{subdomain}` にはプロジェクト固有の値が入ります。KARTE管理画面の「CMS設定」>「APIエンドポイント」で確認できます。\n\n ⚠️ **注意**: Base URLの`{subdomain}`を編集しても、API Requestのコード例には反映されません。Shell/Node/Ruby等のExampleは反映されるのでそちらを使うか、API Requestを利用する場合は`devKarte.server()`で実際のエンドポイントURLを指定してください。\n\n #### Required Scope\n APIの実行に必要なScopeです。\n ```\n beta.cdn.cms.content.list\n ```\n\n #### Required Role\n 管理画面でScopeを追加する際に必要な権限です。\n ```\n Craft > Craft 設定の編集\n ```\n\n #### レート制限\n プロジェクトごとに、1秒あたり80回まで（キャッシュされていないリクエストのみ）です。CDN API・Preview API は別々に数え、一覧取得と単体取得は合算します。超えると `429 Too Many Requests` を返します。`Retry-After` ヘッダーの秒数だけ待ってから再度リクエストしてください。\n ", "security": [ { "bearer": [] } ], "summary": "Get contents", "tags": [ "CDN" ], "parameters": [ { "schema": { "type": "string", "description": "取得するコンテンツが所属するモデルのIDを指定します。", "example": "6347f05d5d18d4536af5f336" }, "required": true, "description": "取得するコンテンツが所属するモデルのIDを指定します。", "name": "modelId", "in": "query" }, { "schema": { "type": "object", "properties": { "id": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.createdAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.updatedAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.modelId": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.customOrder": { "type": "object", "properties": { "$eq": { "type": "number", "nullable": true }, "$ne": { "type": "number", "nullable": true }, "$gt": { "type": "number", "nullable": true }, "$gte": { "type": "number", "nullable": true }, "$lt": { "type": "number", "nullable": true }, "$lte": { "type": "number", "nullable": true }, "$in": { "type": "array", "items": { "type": "number", "nullable": true }, "maxItems": 50 } }, "additionalProperties": false }, "sys.raw.createdAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.raw.updatedAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.raw.firstPublishedAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "sys.raw.publishedAt": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false } }, "default": {}, "additionalProperties": { "type": "object", "properties": { "$eq": { "type": "string" }, "$ne": { "type": "string" }, "$gt": { "type": "string" }, "$gte": { "type": "string" }, "$lt": { "type": "string" }, "$lte": { "type": "string" }, "$in": { "type": "array", "items": { "type": "string" }, "maxItems": 50 } }, "additionalProperties": false }, "description": "取得するコンテンツの条件を指定できます。未入力のフィールドは型に応じた空値（空文字・0・false・null）として保存されるため、$ne は未入力のコンテンツにもマッチします。", "example": { "slug": { "$eq": "post-1" } } }, "required": false, "description": "取得するコンテンツの条件を指定できます。未入力のフィールドは型に応じた空値（空文字・0・false・null）として保存されるため、$ne は未入力のコンテンツにもマッチします。", "name": "filter", "in": "query", "style": "deepObject", "explode": true }, { "schema": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z]" }, "default": [], "description": "取得するコンテンツが持つプロパティを指定できます。複数の値を指定できます。idは必ず含まれます。", "example": [ "title", "slug" ] }, "required": false, "description": "取得するコンテンツが持つプロパティを指定できます。複数の値を指定できます。idは必ず含まれます。", "name": "select", "in": "query", "style": "deepObject", "explode": true }, { "schema": { "type": "array", "items": { "type": "string", "pattern": "^(-[a-zA-Z]|[a-zA-Z])" }, "default": [ "-sys.raw.firstPublishedAt" ], "description": "取得するコンテンツの順番を指定できます。複数の値を指定できます。降順にしたい場合は「-」をつけます。", "example": [ "-sys.createdAt" ] }, "required": false, "description": "取得するコンテンツの順番を指定できます。複数の値を指定できます。降順にしたい場合は「-」をつけます。", "name": "order", "in": "query", "style": "deepObject", "explode": true }, { "schema": { "type": "integer", "nullable": true, "minimum": 0, "default": 0, "description": "何件のコンテンツをスキップするか指定できます。", "example": 0 }, "required": false, "description": "何件のコンテンツをスキップするか指定できます。", "name": "skip", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100, "description": "最大何個のコンテンツを取得するか指定できます。", "example": 100 }, "required": false, "description": "最大何個のコンテンツを取得するか指定できます。", "name": "limit", "in": "query" }, { "schema": { "type": "string", "description": "今後利用する可能性のある予約語です。現在は設定不要です。" }, "required": false, "description": "今後利用する可能性のある予約語です。現在は設定不要です。", "name": "x-karte-api", "in": "header" } ], "responses": { "200": { "description": "Success Response", "headers": { "x-ratelimit-limit": { "description": "キャッシュされていないリクエストについて、1秒あたりに受け付けるリクエスト数の上限です。", "schema": { "type": "integer", "example": 80 } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "skip": { "type": "integer", "minimum": 0, "description": "何件のコンテンツをスキップしているか表します。", "example": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 1000, "description": "最大何個のコンテンツを取得するか表します。", "example": 100 }, "total": { "type": "integer", "minimum": 0, "description": "条件に合致するコンテンツが何個あるか表します。", "example": 246 }, "items": { "type": "array", "items": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "コンテンツのIDです。", "example": "6109f05d5d18d6006af5f385" }, "sys": { "type": "object", "properties": { "createdAt": { "type": "string", "description": "コンテンツの作成日時です。", "example": "2025-04-06T00:18:26.810Z" }, "updatedAt": { "type": "string", "description": "コンテンツの更新日時です。", "example": "2025-04-06T08:39:45.628Z" }, "modelId": { "type": "string", "description": "コンテンツが所属するモデルのIDです。", "example": "6347f05d5d18d4536af5f336" }, "customOrder": { "type": "integer", "minimum": 0, "description": "カスタム順序の値です。", "example": 15 }, "raw": { "type": "object", "properties": { "createdAt": { "type": "string", "description": "コンテンツの作成日時（生データ）です。", "example": "2025-04-05T05:29:09.614Z" }, "updatedAt": { "type": "string", "description": "コンテンツの更新日時（生データ）です。", "example": "2025-04-06T08:39:45.628Z" }, "firstPublishedAt": { "type": "string", "description": "コンテンツの初回公開日時です。", "example": "2025-04-06T00:18:26.810Z" }, "publishedAt": { "type": "string", "description": "コンテンツの最新公開日時です。", "example": "2025-04-06T08:39:45.628Z" } }, "description": "システム情報の生データです。" } }, "description": "システム側で自動で設定された情報が入ります。" } }, "required": [ "id" ] }, { "type": "object", "additionalProperties": { "nullable": true } } ] }, "description": "取得したコンテンツ情報が入ります。" } }, "required": [ "skip", "limit", "total", "items" ], "description": "コンテンツのコレクションをラッパーオブジェクトとして返します。" } } } }, "429": { "description": "Too Many Requests", "headers": { "x-ratelimit-limit": { "description": "キャッシュされていないリクエストについて、1秒あたりに受け付けるリクエスト数の上限です。", "schema": { "type": "integer", "example": 80 } }, "retry-after": { "description": "次にリクエストできるまでの秒数です。", "schema": { "type": "integer", "example": 1 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/karteError" } } } }, "default": { "description": "unexpected error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/karteError" } } } } } } } } } ````