カテゴリ追加 (REST APIリファレンス)/ref_api/record/category_create

新しいカテゴリを追加します。

リクエスト

メソッド

POST

URL

https:////categories/rest_api=1.0/

ヘッダー

パラメータ名値
Content-Type application/json
但しファイルを転送する場合は、multipart/form-data

すべてのリソースで共通するリクエストヘッダーの仕様は、こちらをご参照ください。

コンテント

フィールド名型説明
name 文字列 カテゴリ名
refid 文字列 カテゴリID
description 文字列 概要
keywords 文字列 キーワード
parent_refid 文字列 親カテゴリID（未指定の場合は、最上位に設定されます）
acl ACLオブジェクト 個別アクセスコントロール (ACL)

リクエスト例

curl　-v　-X　POST
　　　　　　　-H　"CONTENT-TYPE:　application/json"　
　　　　　　　-H　"X-ECHO-APP-ID:　fd15eacfaf2388fac2980fef163c6116"　
　　　　　　　-H　"X-ECHO-APP-KEY:　0cdf8bc765d7d9604e83becf93137d42"　
　　　　　　　"https://hogehoge.echopf.com/blogs/categories/rest_api=1.0/"
　　　　　　　-d　'{"name":"カテゴリC",　"refid":"category_c"}'

レスポンス

HTTPステータス

ステータスコード内容
201 追加成功

ヘッダー

パラメータ名値
Content-Type application/json

コンテント

追加したカテゴリデータが出力されます。

フィールド名型説明
categories 配列 カテゴリマップ（各要素はカテゴリマップオブジェクト）

レスポンス例

{"categories":[
　　{
　　　　"refid":"category_c",
　　　　"name":"カテゴリC",
　　　　"description":"カテゴリCです。",
　　　　"keywords":"カテゴリ,C",
　　　　"children":[],
　　　　"acl":{
　　　　　　"*"　{
　　　　　　　　"list":true,
　　　　　　　　"edit":true,
　　　　　　　　"delete":true
　　　　　　}
　　　　}
　　}
]}