参照しているコンテンツのフィールドに対して条件設定する場合、 . に続けて参照先コンテンツのフィールドを指定することができます。

例1: 参照しているコンテンツ内の1行テキストフィールドに対して完全一致条件を指定

/v1/contents/?content_reference.singleline_field[eq]=foobar

例2: 参照しているコンテンツ内の日時テキストフィールドに対して条件指定

/v1/contents/?content_reference.datetime_field[gt]=2023-01-23T04:00:00+09:00

フィールドセット内部のフィールドに対して条件設定する場合、 . に続けてフィールドを指定することができます。

例1: フィールドセット内の1行テキストフィールドに対して完全一致条件を指定

/v1/contents/?field_set.singleline_field[eq]=foobar

例2: フィールドセット内の日時テキストフィールドに対して条件指定

/v1/contents/?field_set.datetime_field[gt]=2023-01-23T04:00:00+09:00

繰り返しフィールドに対して、繰り返し内で条件に合致するフィールドを1件以上含んでいるか否かを条件指定し、絞り込むことができます。
条件設定する場合、 . に続けてフィールドを指定します。
繰り返しフィールドに対する条件設定は [eq] フィルターのみ対応しています。

例1: 繰り返しフィールド内の1行テキストフィールドに対して完全一致条件を指定

/v1/contents/?repeat.singleline_field[eq]=foobar

例2: 繰り返しフィールド内のコンテンツ参照フィールドに対してコンテンツIDを指定

/v1/contents/?repeat.content_reference[eq]=1234567890

※ 参照コンテンツ内のフィールドを条件指定することはできません

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
}