カテゴリ追加 (REST APIリファレンス)

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

リクエスト

メソッド

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":"\u30ab\u30c6\u30b4\u30eaC",
      "description":"\u30ab\u30c6\u30b4\u30eaC\u3067\u3059\u3002",
      "keywords":"\u30ab\u30c6\u30b4\u30ea,C",
      "children":[
        
      ],
      "acl":{
        "*":{
          "list":true,
          "edit":true,
          "delete":true
        }
      }
    }
  ]
}