カテゴリ更新 (REST APIリファレンス)/ref_api/record/category_put

既存カテゴリを更新します。

リクエスト

メソッド

PUT

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 PUT
       -H "CONTENT-TYPE: application/json" 
       -H "X-ECHO-APP-ID: fd15eacfaf2388fac2980fef163c6116" 
       -H "X-ECHO-APP-KEY: 0cdf8bc765d7d9604e83becf93137d42" 
       "https://hogehoge.echopf.com/blogs/categories/category_a/rest_api=1.0/"
       -d '{"name":"カテゴリA2"}'

レスポンス

HTTPステータス

ステータスコード内容
200 更新成功

ヘッダー

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

コンテント

更新後のカテゴリマップが出力されます。

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

レスポンス例

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