いいね!

アイテムの「いいね!」情報を取得/更新する API です。

リクエスト

エンドポイント

https://api.cybozulive.com/api/good/V2

利用可能な HTTP メソッド

GET, POST

必須パラメータ

  • id - 対象のアイテムの ID を指定します。

レスポンス

要素 説明
/feed/entry/cbl:who いいね!をつけている人。
/feed/entry/cblGood:set 自分がいいね!をつけているかどうか。

いいね!をつけている人一覧と自分がつけているかどうかを取得する

Examples

リクエストの例:

GET /api/good/V2?id=GROUP,1:2,BOARD,1:3

レスポンスの例:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:cbl="http://schemas.cybozulive.com/common/2010"
      xmlns:cblGood="http://schemas.cybozulive.com/good/2010">
  <title>サイボウズLive</title>
  <link rel="alternate" href="https://cybozulive.com" />
  <updated>2011-03-05T02:54:33Z</updated>
  <author>
    <name>高橋 健太</name>
    <email>takahashi@example.com</email>
    <uri>1:4</uri>
  </author>
  <entry>
    <link rel="alternate" href="https://cybozulive.com/1_2/gwBoard/view?bid=1%3A3"/>
    <link rel="mobile" href="https://m.cybozulive.com/m/1_2/gwBoard/view?bid=1%3A3"/>
    <updated>2011-03-03T12:54:33Z</updated>
    <category term="GROUP"/>
    <category term="BOARD"/>
    <category term="GOOD"/>
    <id>GROUP,1:2,BOARD,1:3</id>
    <title>ようこそ!</title>
    <summary type="text">グループにメンバーを招待して情報共有しましょう。
      グループの情報を閲覧できるのは、グループメンバーとして追加されたユーザーだけです。

      ■グループの主な機能
      ・イベント
      カレンダー形式でイベントやマイルストーンを共有できます。
      ・ToDoリスト
      担当と期日を決めてToDoをメンバー間で共有できます。
      ・掲示板
      テーマごとにトピックを作成してディスカッションできます。
      ・共有フォルダ
      フォルダを作ってファイルを整理できます。</summary>
    <cbl:group valueString="グループウェア2" id="1:2" />
    <cblGood:set>true</cblGood:set>
    <cbl:who valueString="佐藤 昇" id="1:1" />
    <cbl:who valueString="田中 美子" id="1:11" />
  </entry>
</feed>

いいね!をつける

アイテムの ID を指定して、そのアイテムにいいね!をつけることができます。 アイテムはひとつずつしか指定できません。

要素 説明
/feed/cbl:operation type 属性に insert を指定します。
/feed/entry/id いいね!をつけるアイテムの ID (必須項目)

Examples

リクエストの例:

POST /api/good/V2
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:cbl="http://schemas.cybozulive.com/common/2010">
  <cbl:operation type="insert"/>
  <entry>
    <id>GROUP,1:1,BOARD,1:1,COMMENT,42</id>
  </entry>
</feed>

レスポンスの例:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <entry>
    <id>GROUP,1:1,BOARD,1:1,COMMENT,42</id>
  </entry>
</feed>

いいね!を取り消す

アイテムの ID を指定して、そのアイテムからいいね!を取り消すことができます。 アイテムはひとつずつしか指定できません。

要素 説明
/feed/cbl:operation type 属性に delete を指定します。(必須項目)
/feed/entry/id いいね!を取り消すアイテムの ID (必須項目)

Examples

リクエストの例:

POST /api/good/V2
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:cbl="http://schemas.cybozulive.com/common/2010">
  <cbl:operation type="delete"/>
  <entry>
    <id>GROUP,1:1,BOARD,1:1,COMMENT,42</id>
  </entry>
</feed>

レスポンスの例:

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <entry>
    <id>GROUP,1:1,BOARD,1:1,COMMENT,42</id>
  </entry>
</feed>

エラーコード

書き込み用のデータが不正な場合にはエラーの XML が返ります。 <error> 要素の中身を確認してください。

  • いいね!をつける/取り消す対象となるアイテムが存在しない場合
  • ふたつ以上のアイテムに対して操作を試みた場合