公開 API リファレンス

API only

スタート経路 C

管理画面なしで公開コンテンツを読む入口です。サイト配線はフレームワーク別レシピ。ほかの経路: Agents（MCP） · Console クイックスタート。

デフォルトは認証不要です。すべてのレスポンスは Content-Type: application/json です（/media/:assetId と XML エンドポイントを除く）。

ベース URL

方式	ベース URL	用途
projectId 固定（推奨）	`https://api.luno.rest/public/p/{projectId}/v1`	ローカル検証・マルチテナント。Host 解決に依存しない
Host 解決	`https://{your-domain}/public/v1`	プロジェクトの公開ホスト / カスタムドメイン

projectId は MCP の get_public_api_info、または管理画面のプロジェクト設定から取得できます。ローカル（127.0.0.1）では Host 版が DEFAULT_TENANT_ID に落ちるため、必ず /public/p/{projectId}/v1 を使ってください。

公開 API キー（luno_pub_…）は Embed・Host 解決などで使います。ヘッダー X-Luno-Public-Api-Key（または Authorization: Bearer / クエリ）に付けます。詳細は公開 API キー。エージェントキー（sk-agent-…）とは別物です。

以下のパスはいずれも上記ベースの相対パスです。

フォームセット

GET /form-sets/:slug

フォームセットのメタ情報と、そのプライマリエントリ（slug: main を優先）の公開コンテンツを返します。

パラメータ

パラメータ	場所	型	説明
`slug`	パス	string	フォームセットの slug
`locale`	クエリ	string	ロケール（例: `ja`, `en`）

リクエスト例

curlJSMCP

bash

curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/settings?locale=ja"
# or
curl "https://your-domain.com/public/v1/form-sets/settings?locale=ja"

const BASE = 'https://api.luno.rest/public/p/{projectId}/v1'
const res = await fetch(`${BASE}/form-sets/settings?locale=ja`)
const data = await res.json()

bash

# エージェント例: 「settings フォームセットの公開内容を取得して」

レスポンス例（200）

json

{
  "formSet": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "settings",
    "name": "サイト設定",
    "description": null
  },
  "entry": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "slug": "main"
  },
  "revision": {
    "id": "a2f3d4e5-...",
    "revision": 3,
    "updatedAt": "2025-01-15T10:00:00Z"
  },
  "data": {
    "site_name": "My Website",
    "tagline": "最高のヘッドレス CMS",
    "logo": "asset-uuid",
    "primary_color": "#3b82f6"
  },
  "mediaUrls": {
    "logo": "https://your-domain.com/public/v1/media/asset-uuid"
  }
}

GET /form-sets/:formSetSlug/entries

フォームセットの公開エントリ一覧を返します。

パラメータ

パラメータ	場所	型	デフォルト	説明
`formSetSlug`	パス	string	—	フォームセットの slug
`page`	クエリ	integer	`1`	ページ番号（1 始まり）
`limit`	クエリ	integer	`20`	1 ページあたりの件数（最大 `100`）
`offset`	クエリ	integer	—	オフセット（`page` の代わりに指定可）
`locale`	クエリ	string	—	ロケールフィルター（例: `ja`）
`q`	クエリ	string	—	全文検索キーワード（Business プラン以上）
`sort`	クエリ	string	—	ソートキー（例: `created_at:desc`, `updated_at:asc`）
`include_snapshot`	クエリ	boolean	`false`	`true` でフィールド値・mediaUrls を含める

リクエスト例

curlJSMCP

bash

# ページ 1（デフォルト）
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries"

# フィールド値付きで 5 件
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries?limit=5&include_snapshot=true"

# 全文検索（Business 以上） / ソート
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries?q=cloudflare&locale=ja"
curl "https://api.luno.rest/public/p/{projectId}/v1/form-sets/blog/entries?sort=updated_at:desc"

const BASE = 'https://api.luno.rest/public/p/{projectId}/v1'
const qs = new URLSearchParams({
  limit: '5',
  include_snapshot: 'true',
  sort: 'updated_at:desc',
})
const res = await fetch(`${BASE}/form-sets/blog/entries?${qs}`)
const data = await res.json()

bash

# エージェント例: 「blog の公開エントリを更新日時降順で 5 件、本文付きで」

レスポンス例（200）

json

{
  "formSet": {
    "id": "uuid",
    "slug": "blog",
    "name": "ブログ",
    "description": null
  },
  "total": 42,
  "limit": 20,
  "offset": 0,
  "items": [
    {
      "entry": {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "slug": "my-first-post"
      },
      "published": {
        "revisionId": "a2f3d4e5-...",
        "revision": 2,
        "updatedAt": "2025-01-15T10:00:00Z"
      }
    },
    {
      "entry": {
        "id": "another-uuid",
        "slug": "second-post"
      },
      "published": {
        "revisionId": "b3e4f5a6-...",
        "revision": 1,
        "updatedAt": "2025-01-10T08:00:00Z"
      }
    }
  ]
}

include_snapshot=true の場合、各 published オブジェクトに snapshot（フィールド値）と mediaUrls が追加されます：

json

{
  "items": [
    {
      "entry": { "id": "uuid", "slug": "my-first-post" },
      "published": {
        "revisionId": "uuid",
        "revision": 2,
        "updatedAt": "2025-01-15T10:00:00Z",
        "snapshot": {
          "title": "はじめての投稿",
          "cover": "asset-uuid",
          "category": "blog"
        },
        "mediaUrls": {
          "cover": "https://your-domain.com/public/v1/media/asset-uuid"
        }
      }
    }
  ]
}

GET /form-sets/:formSetSlug/entries/:entrySlug

特定エントリの公開コンテンツを返します。slug が変更されていた場合は HTTP 301 を返します。

パラメータ

パラメータ	場所	型	説明
`formSetSlug`	パス	string	フォームセットの slug
`entrySlug`	パス	string	エントリの slug
`locale`	クエリ	string	ロケール（例: `ja`, `en`）

リクエスト例

bash

# 基本取得
curl https://your-domain.com/public/v1/form-sets/blog/entries/my-first-post

# 日本語ロケールで取得
curl "https://your-domain.com/public/v1/form-sets/blog/entries/my-first-post?locale=ja"

レスポンス例（200）

json

{
  "formSet": {
    "id": "uuid",
    "slug": "blog",
    "name": "ブログ"
  },
  "entry": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "slug": "my-first-post"
  },
  "revision": {
    "id": "a2f3d4e5-...",
    "revision": 2,
    "updatedAt": "2025-01-15T10:00:00Z"
  },
  "data": {
    "title": "はじめての投稿",
    "body": "<h2>はじめに</h2><p>こんにちは、世界！</p>",
    "cover": "asset-uuid-here",
    "category": "blog",
    "tags": ["cloudflare", "cms"],
    "published_date": "2025-01-15",
    "is_featured": true
  },
  "mediaUrls": {
    "cover": "https://your-domain.com/public/v1/media/asset-uuid-here"
  },
  "widgetRoles": {
    "title": "title",
    "cover": "thumbnail",
    "body": "description"
  }
}

slug 変更時（301）

http

HTTP/1.1 301 Moved Permanently
Location: /public/v1/form-sets/blog/entries/new-slug

コンテンツ参照

GET /content/by-path

インポートパスからコンテンツを取得します。外部システムからデータを移行した後に旧 URL でコンテンツを引けるようにする際に使用します。

パラメータ

パラメータ	場所	型	説明
`path`	クエリ	string	インポート時に設定したパス（必須）
`locale`	クエリ	string	ロケール（任意）

リクエスト例

bash

curl "https://your-domain.com/public/v1/content/by-path?path=/old-system/articles/123"

レスポンスは GET /form-sets/:slug/entries/:slug と同形式。

GET /content/by-slug

フォームセット slug とエントリ slug をクエリパラメータ形式で指定してコンテンツを取得します。

パラメータ

パラメータ	場所	型	説明
`formSetSlug`	クエリ	string	フォームセットの slug（必須）
`slug`	クエリ	string	エントリの slug（必須）
`locale`	クエリ	string	ロケール（任意）

bash

curl "https://your-domain.com/public/v1/content/by-slug?formSetSlug=blog&slug=my-post&locale=ja"

GET /content/by-external-id

外部システムのエンティティ ID からコンテンツを取得します。

パラメータ

パラメータ	場所	型	最大長	説明
`sourceType`	クエリ	string	50	外部システム名（例: `wordpress`, `shopify`）
`entityType`	クエリ	string	200	エンティティ種別（例: `post`, `product`）
`externalId`	クエリ	string	2000	外部システムの ID（必須）
`locale`	クエリ	string	—	ロケール（任意）

bash

curl "https://your-domain.com/public/v1/content/by-external-id?sourceType=wordpress&entityType=post&externalId=12345"

プレビュー

GET /preview/revisions

署名付き JWT トークンを使って、未公開リビジョンのコンテンツをプレビューします。

パラメータ

パラメータ	場所	型	説明
`token`	クエリ	string	管理画面から発行した JWT トークン（必須）

bash

curl "https://your-domain.com/public/v1/preview/revisions?token=eyJhbGciOiJIUzI1NiJ9..."

ケース	レスポンス
有効なトークン	200 + エントリ詳細（draft も含む）
トークン期限切れ	401 `UNAUTHORIZED`
トークン不正	401 `UNAUTHORIZED`

トークンは管理画面のエントリ編集画面から生成できます（有効期限 15 分）。

メディア

GET /media/:assetId

アップロードされたメディアファイルを返します。

パラメータ

パラメータ	場所	型	説明
`assetId`	パス	string（UUID）	メディアの asset ID

bash

# 画像を取得
curl https://your-domain.com/public/v1/media/550e8400-e29b-41d4-a716-446655440001

# WebP を要求（対応ブラウザのみ）
curl -H "Accept: image/webp" \
  https://your-domain.com/public/v1/media/550e8400-e29b-41d4-a716-446655440001

レスポンスヘッダー

http

Content-Type: image/jpeg
Cache-Control: public, max-age=31536000
ETag: "abc123def456"

サイトマップ

GET /sitemap.xml

全フォームセットの全公開エントリを含む XML サイトマップを返します。

bash

curl https://your-domain.com/public/v1/sitemap.xml

xml

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://your-site.com/blog/my-first-post</loc>
    <lastmod>2025-01-15T10:00:00Z</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

GET /form-sets/:slug/sitemap.xml

特定フォームセットのエントリのみを含む XML サイトマップを返します。

bash

curl https://your-domain.com/public/v1/form-sets/blog/sitemap.xml

SEO

GET /form-sets/:formSetSlug/entries/:entrySlug/schema.json

schema.org JSON-LD を返します。<script type="application/ld+json"> に埋め込みます。

bash

curl https://your-domain.com/public/v1/form-sets/blog/entries/my-post/schema.json

json

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "はじめての投稿",
  "description": "記事の説明文",
  "image": "https://your-domain.com/public/v1/media/asset-uuid",
  "datePublished": "2025-01-15T10:00:00Z",
  "dateModified": "2025-01-15T10:00:00Z",
  "author": { "@type": "Organization", "name": "My Blog" }
}

GET /form-sets/:formSetSlug/entries/:entrySlug/ogp.json

OGP メタ情報を JSON 形式で返します。

bash

curl https://your-domain.com/public/v1/form-sets/blog/entries/my-post/ogp.json

json

{
  "og:title": "はじめての投稿",
  "og:description": "記事の説明文",
  "og:image": "https://your-domain.com/public/v1/media/asset-uuid",
  "og:url": "https://your-site.com/blog/my-post",
  "og:type": "article",
  "og:site_name": "My Blog",
  "twitter:card": "summary_large_image"
}

コンタクトフォーム

POST /contact-forms/:slug/submit

コンタクトフォームにデータを送信します。

POST /public/v1/contact-forms/contact/submit
Content-Type: application/json

bash

curl -X POST https://your-domain.com/public/v1/contact-forms/contact/submit \
  -H "Content-Type: application/json" \
  -d '{
    "name": "山田 太郎",
    "email": "[email protected]",
    "message": "お問い合わせ内容をここに記入します。"
  }'

成功レスポンス（200）

json

{
  "ok": true,
  "submissionId": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

バリデーションエラー（400）

json

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "email is required"
  }
}

マスタ（公開）

サイトへ公開済み（site_published_at あり）のマスタエンティティとレコードを取得できます。未公開は一覧に出ず、個別取得も 404 です。レコードの value は言語共通 ID、label は ?locale= で解決した表示名です。概要は Masters。

bash

curl https://api.luno.rest/public/p/{projectId}/v1/master-entities
curl "https://api.luno.rest/public/p/{projectId}/v1/master-entities/category/records?locale=ja"

AI エージェント向け

GET /llms.txt

AI クローラー・エージェント向けの公開コンテンツ一覧（llms.txt 仕様準拠）を返します。

curlJSMCP

bash

curl https://api.luno.rest/public/p/{projectId}/v1/llms.txt
# or
curl https://your-domain.com/public/v1/llms.txt

const text = await fetch(
  'https://api.luno.rest/public/p/{projectId}/v1/llms.txt'
).then((r) => r.text())

bash

# エージェント例: 「このプロジェクトの llms.txt を読んで公開構造を要約して」

docs サイトの llms-full.txt

長い API 要約は ドキュメントサイトの llms-full.txt です。製品の公開 API には /llms-full.txt エンドポイントはありません。

MCP 設定・エージェントキーのスコープ・管理 API の詳細は AI エージェント向けガイドを参照してください。

フィールド値の型リファレンス

data オブジェクト内のフィールド値の型：

フィールドタイプ	型	例
`text` / `url`	`string`	`"はじめての投稿"`
`textarea`	`string`	`"複数行\nテキスト"`
`tiptap`	Tiptap doc(JSON) または `string`	`"<h2>見出し</h2><p>本文</p>"`
`number`	`number`	`1980`
`boolean`	`boolean`	`true`
`date`	`string` または `{ from, to }`	`"2025-01-15"`
`select` / `radio`	`string`（マスタ value）	`"blog"`
`multiselect`	`string[]`	`["tag1", "tag2"]`
`image` / `file`	`string`（asset UUID）	`"550e8400-..."`
`image_gallery`	UUID 文字列、または `{ assetId, caption? }[]`	`[{ "assetId": "…" }]`
`video_embed`	`string`（URL）	`"https://youtube.com/..."`
`entry_ref`	`string`（参照エントリ UUID）	`"7c9e6679-..."`

image / file の UUID は mediaUrls[fieldKey] で完全 URL に解決されます。/public/p/{projectId}/v1 で取得した場合、mediaUrls も同じプレフィックスになります。

公開 API リファレンス ​

API only ​

ベース URL ​

フォームセット ​

GET /form-sets/:slug ​

GET /form-sets/:formSetSlug/entries ​

GET /form-sets/:formSetSlug/entries/:entrySlug ​

コンテンツ参照 ​

GET /content/by-path ​

GET /content/by-slug ​

GET /content/by-external-id ​

プレビュー ​

GET /preview/revisions ​

メディア ​

GET /media/:assetId ​

サイトマップ ​

GET /sitemap.xml ​

GET /form-sets/:slug/sitemap.xml ​

SEO ​

GET /form-sets/:formSetSlug/entries/:entrySlug/schema.json ​

GET /form-sets/:formSetSlug/entries/:entrySlug/ogp.json ​

コンタクトフォーム ​

POST /contact-forms/:slug/submit ​

マスタ（公開） ​

AI エージェント向け ​

GET /llms.txt ​

フィールド値の型リファレンス ​

公開 API リファレンス

API only

ベース URL

フォームセット

GET /form-sets/:slug

GET /form-sets/:formSetSlug/entries

GET /form-sets/:formSetSlug/entries/:entrySlug

コンテンツ参照

GET /content/by-path

GET /content/by-slug

GET /content/by-external-id

プレビュー

GET /preview/revisions

メディア

GET /media/:assetId

サイトマップ

GET /sitemap.xml

GET /form-sets/:slug/sitemap.xml

SEO

GET /form-sets/:formSetSlug/entries/:entrySlug/schema.json

GET /form-sets/:formSetSlug/entries/:entrySlug/ogp.json

コンタクトフォーム

POST /contact-forms/:slug/submit

マスタ（公開）

AI エージェント向け

GET /llms.txt

フィールド値の型リファレンス