Garoon APIドキュメント

ToDoを登録する

目次

ToDoを登録する

固定リンクがコピーされました

APIを実行したユーザー個人のToDoリストに新しいToDoを登録します。

URL

固定リンクがコピーされました

クラウド版

https://sample.cybozu.com/g/api/v1/todo/todos

パッケージ版

環境に合わせてそれぞれ以下を置き換えてください。

  • IP_ADDRESS_OR_HOST_NAME：Garoonのインストール先のIPアドレスまたはホスト名
  • INSTALL_IDENTIFER：Garoonのインストール識別子
Windows環境
http://IP_ADDRESS_OR_HOST_NAME/scripts/INSTALL_IDENTIFER/grn.exe/api/v1/todo/todos
Linux環境
http://IP_ADDRESS_OR_HOST_NAME/cgi-bin/INSTALL_IDENTIFER/grn.cgi/api/v1/todo/todos

HTTPメソッド

固定リンクがコピーされました

POST

利用できるバージョン

固定リンクがコピーされました

  • クラウド版Garoon
  • パッケージ版Garoon 6.0以降

必要なアクセス権

固定リンクがコピーされました

なし

リクエスト

固定リンクがコピーされました

パラメーター
パラメーター名 型 必須 説明
category 数値 省略可 カテゴリーID
省略すると、「すべて」のカテゴリが設定されます。
subject 文字列 必須 ToDo名
100文字以内で指定します。
dueDate 文字列 省略可 ToDoの締切日
ISO8601形式で表示されます。
省略すると、「締切日なし」が設定されます。
priority 数値 省略可 ToDoの重要度
次のいずれかの値を指定します。数が大きいほど重要度は高くなります。
  • 1
  • 2
  • 3
省略すると、初期値の「2」が設定されます。
notes 文字列 省略可 メモ
改行文字は「\n」です。
リクエストの例
URL

https://sample.cybozu.com/g/api/v1/todo/todos

ヘッダー
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

リクエストヘッダーの詳細は Garoon REST APIの共通仕様を参照してください。

ボディ
1
2
3
4
5
6
7

{
  "category": 0,
  "subject": "Todo 1",
  "dueDate": "2023-01-12T12:00:00+07:00",
  "priority": 1,
  "notes": "It is notes"
}

レスポンス

固定リンクがコピーされました

プロパティ
プロパティ名 型 説明
id 数値 ToDoのID
status 文字列 ToDoのステータス
次のいずれかの値が返ります。
  • Completed：完了
  • Uncompleted：未処理
category 数値 ToDoのカテゴリーID
subject 文字列 ToDo名
hasDueDate 真偽値 締切日があるかどうか
  • true：ToDoの締切日が設定されている
  • false：ToDoの締切日が設定されていない
dueDate 文字列 ToDoの締切日
形式はISO8601のUTCタイムゾーンです。
hasDueDateの値がfalseの場合、このプロパティはオブジェクトに含まれません。
priority 数値 ToDoの重要度
次のいずれかの値が返ります。数が大きいほど重要度は高くなります。
  • 1
  • 2
  • 3
notes 文字列 メモ
改行文字は「\n」です。
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "id": 1,
  "status": "Uncompleted",
  "category": 0,
  "subject": "Todo 1",
  "hasDueDate": true,
  "dueDate": "2023-01-12T12:00:00+07:00",
  "priority": 1,
  "notes": "It is notes"
}

サンプルコード

固定リンクがコピーされました

curlを使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

curl -X POST 'https://sample.cybozu.com/g/api/v1/todo/todos' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "category": 0,
    "subject": "Todo 1",
    "dueDate": "2023-01-12T12:00:00+07:00",
    "priority": 1,
    "notes": "It is notes"
  }'
Garoon REST APIリクエストを送信するAPIを使ったリクエスト
1
2
3
4
5
6
7
8
9

const body = {
  category: 0,
  subject: 'Todo 1',
  dueDate: '2023-01-12T12:00:00+07:00',
  priority: 1,
  notes: 'It is notes'
};

await garoon.api('/api/v1/todo/todos', 'POST', body);

注意事項

固定リンクがコピーされました

  • スペースの共有ToDoは操作できません。