新規ページの作成
新規ページを作成します。
APIへのすべてのリクエストには、APIトークンが必要です。トークンは、APIプラグインの設定で確認できます。
管理パネル > ブラグイン > API > APIトークンコンテンツを書き込むためのAPIへのすべてのリクエストは、認証トークンを提供する必要があります。このトークンを取得するには、管理者ロールを持つユーザーが必要です。ユーザープロファイルから認証トークンを取得します。
管理パネル > 管理 > ユーザー > {ユーザー名} > セキュリティ > 認証トークンHTTPリクエスト
POST /api/pages/{key}パラメータ
| キー | 値 | デフォルト値 |
|---|---|---|
required token |
string APIトークン |
|
required authentication |
string 認証トークン |
|
| title | string ページタイトル |
|
| content | string ページ内容 |
|
| tags | string ページタグ(CSV) |
|
| type | string ページタイプ |
|
| date | string ページ日付 (形式 "YYYY-MM-DD Hours:Minutes:Seconds") |
|
| slug | string ページURLスラッグ |
(小文字タイトルから生成) |
| dateModified | string ページ修正日 |
|
| position | string ページ位置 |
|
| coverImage | string ページカバー画像 |
|
| category | string ページカテゴリー |
|
| template | string ページテンプレート |
|
| noindex | string noindexページ |
|
| nofollow | string nofollowページ |
|
| noarchive | string noarchiveページ |
レスポンス
HTTP Code: 200
Content-Type: application/json
Body:
{
"status": "0",
"message": "Page created.",
"data": {
"key": "<page key>"
}
}CURLコマンド例
ここでは、curlコマンドを使ってコマンドラインから新しいページを作成する例を紹介します。data.jsonファイルには、新しいページの作成に必要な基本データが入っています。
ファイルdata.jsonの内容
{
"token": "24a8857ed78a8c89a91c99afd503afa7",
"authentication": "193569a9d341624e967486efb3d36d75",
"title": "My dog",
"content": "Content of the page here, support Markdown code and HTML code."
}コマンドを実行し、data.jsonファイルを添付します。
$ curl -X POST \
-H "Content-Type: application/json" \
-d @data.json \
"https://www.example.com/api/pages"レスポンス本体
{
"status": "0",
"message": "Page created.",
"data": {
"key": "my-dog"
}
}