flexibletext_field[format]=htmlを指定した場合（デフォルト動作）

"flexibletext_field": "<h2>abcdef</h2><p>abcdef</p><ul><li>abcdef</li></ul>"

flexibletext_field[format]=textを指定した場合

"flexibletext_field": "abcdef abcdef abcdef"

flexibletext_field[format]=markdownを指定した場合

"flexibletext_field": "## abcdef\n\nabcdef\n\n* abcdef"

flexibletext_field[format]=portable_htmlを指定した場合

"flexibletext_field": "<h2 data-nilto-ftelm='123123123'>abcdef</h2><p data-nilto-ftelm='456456456'>abcdef</p><ul data-nilto-ftelm='789789789'><li>abcdef</li></ul>"

※ポータブルHTML（portable_html）
書き込みAPIでのフレキシブルテキストフィールドへのデータ登録に適した独自HTMLフォーマットです。
アドオン要素が適用された状態でフレキシブルテキストフィールドにデータ登録することができます。

"singleline_field": "foobar"

"multiline_field": "foobar\r\nfoobar"

"boolean_field": true

"singleselect_field": "value"

"multiselect_field": [
    "value1",
    "value2",
    "value3"
]

"datetime_field": "2023-01-23T04:50:00Z"

日時は ISO 8601 形式のUTC（協定世界時）で表現されます。

"media_field": {
    "url": "https://cms-assets.nilto.com/spaces/1234567890/media/2345678901/_/abc.png",
    "alt": "alternative text"
}

NILTO のメディアは Fastly Image Optimizer に対応しています。
URLの末尾にクエリパラメータを付与することで、画像のリサイズやフォーマット変換が可能です。

代表的なパラメータ:

• ?width=800 : 幅を指定
• ?height=600 : 高さを指定
• ?format=webp : WebPに変換
• ?fit=bounds : アスペクト比を維持して収める

詳細は Fastory IO 仕様 を参照してください。

"reference_field": {
    "_id": 2345678901,
    "_model": "referenced",
    "_title": "Hello World2",
    "_created_at": "2023-01-23T04:50:00Z",
    "_updated_at": "2023-01-23T04:50:00Z",
    "_published_at": "2023-01-23T04:50:00Z",
    "_status": "published",
    "singleline_field": "foobar"
}

繰り返しは、フィールドの集合であるオブジェクトの配列で表現されます。

"repeat_field": [
    {
        "singleline_field": "foo",
        "boolean_field": true
    },
    {
        "singleline_field": "foobar",
        "boolean_field": false
    },
    {
        "singleline_field": "foobarbaz",
        "boolean_field": true
    }
]

組み合わせは、フィールドセットのデータであるオブジェクトの配列で表現されます。 フィールドセット内のluidは指定したLUIDです。fieldsはフィールドセット内フィールドです。

"combination_field": [
    {
        "luid": "field_set_a",
        "fields": {
            "singleline_field": "foo",
            "boolean_field": true
        }
    },
    {
        "luid": "field_set_b",
        "fields": {
            "datetime_field": "2023-01-23T04:50:00Z",
            "singleselect_field": "value"
        }
    },
    {
        "luid": "field_set_a",
        "fields": {
            "singleline_field": "foobar",
            "boolean_field": false
        }
    }
]

"field_set": {
    "singleline": "foobar",
    "boolean": true
}

ID指定でのコンテンツ取得時に有効。
コンテンツを一覧取得した際の、指定コンテンツの「前」に該当するコンテンツ情報を_prev プロパティキーで取得。

コンテンツの「前後」は一覧取得用のクエリパラメータ（ order キーや各種フィルター条件）を元に判定します。

同一条件でヒットするコンテンツが1,000件を超える場合、_prevデータを正しく取得できない可能性があります。
フィルター条件を調整してください。

リクエスト例

/v1/contents/1234567890/?include=_prev

レスポンス例

{
    "_id": 1234567890,
    "_model": "news",
    "_title": "Current Content",
    "_created_at": "2023-01-23T04:50:00Z",
    "_updated_at": "2023-01-23T04:50:00Z",
    "_published_at": "2023-01-23T04:50:00Z",
    "_last_published_at": "2023-01-23T04:50:00Z",
    "_status": "published",
    "_space": "_parent",
    "_prev": {
        "_id": 1111111111,
        "_model": "news",
        "_title": "Previous Content",
        "_created_at": "2023-02-01T04:50:00Z",
        "_updated_at": "2023-02-01T04:50:00Z",
        "_published_at": "2023-02-01T04:50:00Z",
        "_last_published_at": "2023-02-01T04:50:00Z",
        "_status": "published",
        "_space": "_parent",
        "flexibletext_field": "<div><h2>Previous Content H2</h2><p>abcedf</p></div>",
        "singleline_field": "previous",
        "boolean_field": true
    },
    "flexibletext_field": "<div><h2>Current Content H2</h2><p>abcedf</p></div>",
    "singleline_field": "foobar",
    "boolean_field": true
}

ID指定でのコンテンツ取得時に有効。
コンテンツを一覧取得した際の、指定コンテンツの「後」に該当するコンテンツ情報を_next プロパティキーで取得。

コンテンツの「前後」は一覧取得用のクエリパラメータ（ order キーや各種フィルター条件）を元に判定します。

同一条件でヒットするコンテンツが2,000件を超える場合、_nextデータを正しく取得できない可能性があります。
フィルター条件を調整してください。

リクエスト例

/v1/contents/1234567890/?include=_next

レスポンス例

{
    "_id": 1234567890,
    "_model": "news",
    "_title": "Current Content",
    "_created_at": "2023-01-23T04:50:00Z",
    "_updated_at": "2023-01-23T04:50:00Z",
    "_published_at": "2023-01-23T04:50:00Z",
    "_last_published_at": "2023-01-23T04:50:00Z",
    "_status": "published",
    "_space": "_parent",
    "_next": {
        "_id": 2222222222,
        "_model": "news",
        "_title": "Next Content",
        "_created_at": "2023-01-01T04:50:00Z",
        "_updated_at": "2023-01-01T04:50:00Z",
        "_published_at": "2023-01-01T04:50:00Z",
        "_last_published_at": "2023-01-01T04:50:00Z",
        "_status": "published",
        "_space": "_parent",
        "flexibletext_field": "<div><h2>Next Content H2</h2><p>abcedf</p></div>",
        "singleline_field": "next",
        "boolean_field": true
    },
    "flexibletext_field": "<div><h2>Current Content H2</h2><p>abcedf</p></div>",
    "singleline_field": "foobar",
    "boolean_field": true
}

例1: blogsモデルをorder_fieldでソートした際の、前後のコンテンツ情報を取得

/v1/contents/1234567890/?model=blogs&order=order_field&include=_prev,_next

例2:さらに、selectキーを細かく指定して、前後のコンテンツ情報のうち一部プロパティのみ取得

/v1/contents/1234567890/?model=blogs&order=order_field&include=_prev,_next&select=_prev._id,_prev.singleline_field,_next._id,_next.singleline_field

レスポンスイメージ

{
    "_id": 1234567890,
    "_model": "news",
    "_title": "Current Content",
    "_created_at": "2023-01-23T04:50:00Z",
    "_updated_at": "2023-01-23T04:50:00Z",
    "_published_at": "2023-01-23T04:50:00Z",
    "_last_published_at": "2023-01-23T04:50:00Z",
    "_status": "published",
    "_space": "_parent",
    "_prev": {
        "_id": 1111111111,
        "singleline_field": "previous"
    },
    "_next": {
        "_id": 2222222222,
        "singleline_field": "next"
    },
    "flexibletext_field": "<div><h2>Current Content H2</h2><p>abcedf</p></div>",
    "singleline_field": "foobar",
    "boolean_field": true
}