NILTO

ヘルプセンター

コンテンツを作成する（POST /contents）

基本情報

ベータ版機能について

この機能はベータ版での提供となっており、動作が不安定な場合があります。
また、今後互換性を保たない変更が加わる可能性があります。

あらかじめご了承いただいた上でのご利用をお願いいたします。

コンテンツを1件新規作成します。

POST/v1/contents

https://cms-api.nilto.com/v1/contents

リクエスト

リクエストパラメータ

X-NILTO-API-KEY

X-NILTO-API-KEY

NILTO APIキー。

スペース設定のAPIキー画面で取得することができます。

model必須

string
Example: model=blog,news
登録対象とするモデルのLUIDを指定します。

published

boolean
Default: false
Example: published=true
コンテンツを公開状態で作成するかどうかを指定します。

space

string
Default: "_parent"
Example: space=demo
コンテンツを作成したいスペースのLUIDを指定します。

ft_format

string
Default: "portable_html"
Enum: "portable_html" "markdown"
Example: ft_format=markdown
フレキシブルテキストフィールドにデータ登録したい場合、HTMLデータとして取り込むかマークダウンデータとして取り込むかを指定します。

fields必須

object (contentRequest)
{フィールドLUID: 入力値}の形式のオブジェクト。
言語キー未指定時はメイン言語として登録します。

fields[{lang_key}]

object (contentRequest)
{フィールドLUID: 入力値}の形式のオブジェクト。
[] 内は利用中言語の言語キーを指定。同時に複数の言語キーを指定できます。

meta

object (contentRequest)
{プロパティキー: 入力値}の形式のオブジェクト。

現在以下のプロパティに対応しています。

_published_at : コンテンツの公開日時

_last_published_at: コンテンツの最終公開 日時

リクエスト例

curl
curl -X POST "https://cms-api.nilto.com/v1/contents?model=news&published=false" \
     -H "X-NILTO-API-KEY: 0000000000000000000000" \
     -H "Content-Type: application/json" \
     -d '{
       "fields": {
         "flexibletext_field": "<h2>タイトル</h2><p>本文のテキストです。</p>",
         "singleline_field": "1行テキストのサンプル",
         "boolean_field": true,
         "datetime_field": "2023-03-07T19:00:00Z"
       }
     }'
Payload
{
  "fields": {
    "flexibletext_field": "<h2>abcedf</h2><p>abcedf</p><ul><li>abcedf</li><li>abcedf</li>",
    "singleline_field": "foobar",
    "multiline_field": "foo\nbar",
    "boolean_field": true,
    "singleselect_field": "value1",
    "datetime_field": "2023-01-23T04:50:00Z",
    "media_field": 1234567890,
    "repeat_field": [],
    "reference_field": 1234567890,
    "field_set1": {
      "singleline_field": "foobar",
      "boolean_field": true
    },
    "field_set2": {
      "multiline_field": "foo\nbar",
      "datetime_field": "2023-01-23T04:50:00Z"
    },
    "combination_field": [
      {
        "luid": "field_set_a",
        "fields": {
          "multiline_field": "foo\nbar",
          "boolean_field": true
        }
      },
      {
        "luid": "field_set_b",
        "fields": {
          "datetime_field": "2023-01-23T04:50:00Z",
          "repeat_field": []
        }
      },
      {
        "luid": "field_set_a",
        "fields": {
          "multiline_field": "foo\nbar\nbaz",
          "boolean_field": false
        }
      }
  ]},
  "fields[en]": {
    "singleline_field": "foobar"
  },
  "fields[zh-CN]": {
    "singleline_field": "foobar"
  },
  "meta": {
    "_published_at": "2023-01-23T04:50:00Z",
    "_last_published_at": "2023-04-01T09:00:00Z"
  }
}

レスポンス

200 OK

id

integer

コンテンツID

400 Bad Request

status

string
Value: "400"
HTTPステータスコード

code

string
Value: "BadRequest"
エラーを識別するためのコード

401 Unauthorized

status

string
Value: "401"
HTTPステータスコード

code

string
Value: "Unauthorized"
エラーを識別するためのコード

402 Payment Required

status

string
Value: "402"
HTTPステータスコード

code

string
Value: "Payment Required"
エラーを識別するためのコード

403 Forbidden

status

string
Value: "403"
HTTPステータスコード

code

string
Value: "Forbidden"
エラーを識別するためのコード

404 Not Found

status

string
Value: "404"
HTTPステータスコード

code

string
Value: "Not Found"
エラーを識別するためのコード

429 Too Many Requests

status

string
Value: "429"
HTTPステータスコード

code

string
Value: "Too Many Requests"
エラーを識別するためのコード

message

string
次のリクエストが可能になるまでの残り秒数を含むメッセージ。 秒数そのものはretry-afterヘッダーで返されます。

500 Internal Server Error

status

string
Value: "500"
HTTPステータスコード

code

string
Value: "Internal Server Error"
エラーを識別するためのコード

レスポンス例

200
{
   "id": 1234567890
 }
400
{
   "status": "400",
   "code": "BadRequest"
}
401
{
   "status": "401",
   "code": "Unauthorized"
}
402
{
   "status": "402",
   "code": "Payment Required"
}
403
{
  "status": "403",
  "code": "Forbidden"
}
404
{
  "status": "404",
  "code": "Not Found"
}
429
{
  "status": "429",
  "code": "Too Many Requests",
  "message": "Expected available in 58 seconds."
}
500
{
  "status": "500",
  "code": "Internal Server Error"
}

お困りごとは解決しましたか？

解決しない場合は、サポートへお問い合わせください。

サポートに問い合わせる

目次