ノート

ノート

ノート検索

GET /api/v1/notes HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
include_archived アーカイブノートを含めるかどうか false
page ページ 1
per_page ページ毎の取得数 20 100
{
  "inculde_archived": false,
  "page": 1,
  "per_page": 20
}
Copy

Response

HTTP/1.1 200 OK
{
  "notes": [
    {
      "note_code": "abcdef",
      "name": "ノートの名前",
      "description": "ノートの説明",
      "icon_url": "https://projectmode.notepm.jp/assets/img/notes/s_icon_notepm.png",
      "archived": false,
      "scope": "open", /* open, private */
      "groups": [
        {
          "name": "役員"
        },
        {
          "name": "エンジニア"
        }
      ],
      "users": [
        {
          "user_code": "0000000001",
          "name": "Aさん",
        },
        {
          "user_code": "0000000002",
          "name": "Bさん",
        }
      ]
    }
  ],
  "meta": {
    "previous_page": null,
    "next_page": "https://projectmode.notepm.jp/api/v1/notes?inculde_archived=0&page=2&per_page=20",
    "page": 1,
    "per_page": 20,
    "total": 100
  }
}
Copy

ノート詳細取得

GET /api/v1/notes/:note_code HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値

Copy

Response

HTTP/1.1 200 OK
{
  "note":  {
    "note_code": "abcdef",
    "name": "ノートの名前",
    "description": "ノートの説明",
    "icon_url": "https://projectmode.notepm.jp/assets/img/notes/s_icon_notepm.png",
    "archived": false,
    "scope": "open", /* open, private */
    "users": [
      {
        "user_code": "0000000001",
        "name": "Aさん",
      }
    ],
    "groups": [
      {
        "name": "グループA",
      }
    ]
  },
  "meta": {
  }
}
Copy

ノート作成

POST /api/v1/notes HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
icon ノートに設定するアイコン画像。
BASE64でencodeしたStringを設定する。
name ノート名 20文字
description ノートの説明 200文字
scope open:チームユーザー全員が参加。
private:個別に参加ユーザーを設定する。
groups scope = privateの時のみ有効。
グループ名の配列を設定する。
users ユーザーコードの配列を設定する。
自分のユーザーコードを設定する必要はありません。
scope = openの時、未設定でもチームユーザー全員が参加します。ゲスト権限は個別に招待する必要があります。
{
  "icon": "xxxxx", /* BASE64でencodeしたString */
  "name": "ノート名",
  "description": "ノートの説明",
  "scope": "private", /* open, private */
  "groups": [
    "役員", "エンジニア"
  ],
  "users": [
    "0000000001",
    "0000000002"
  ]
}
Copy

Response

HTTP/1.1 201 Created
{
  "note": [
    {
      "note_code": "abcdef",
      "name": "ノートの名前",
      "description": "ノートの説明",
      "icon_url": "https://projectmode.notepm.jp/assets/img/notes/s_icon_notepm.png",
      "archived": false,
      "scope": "open", /* open, private */
      "groups": [
        {
          "name": "役員"
        },
        {
          "name": "エンジニア"
        }
      ],
      "users": [
        {
          "user_code": "0000000001"
          "name": "Aさん"
        },
        {
          "user_code": "0000000002"
          "name": "Bさん"
        }
      ],
      "services": []
    }
  ],
  "meta": {
  }
}

Copy

ノート更新

PATCH /api/v1/notes/:note_code HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
note_code 更新するノートのコード
icon ノートに設定するアイコン画像。
BASE64でencodeしたStringを設定する。
※アイコンを削除する場合は空の値を指定する。
name ノート名 20文字
description ノートの説明 200文字
scope open:チームユーザー全員が参加。
private:個別に参加ユーザーを設定する。
groups scope = privateの時のみ有効。
グループ名の配列を設定する。
※削除する場合は空の値を指定する
users scope = privateの時のみ有効。
ユーザーコードの配列を設定する。
{
  "note_code": "abcdef"
  "icon_delete": true,
  "name": "ノート名",
  "description": "ノートの説明",
  "scope": "open", /* open, private */
}
Copy

Response

HTTP/1.1 200 OK
{
  "notes": [
    {
      "note_code": "abcdef",
      "name": "ノートの名前",
      "description": "ノートの説明",
      "icon_url": "https://projectmode.notepm.jp/assets/img/notes/s_icon_notepm.png",
      "archived": false,
      "scope": "open", /* open, private */
      "groups": [
        {
          "name": "役員"
        },
        {
          "name": "エンジニア"
        }
      ],
      "users": [
        {
          "user_code": "0000000001",
          "name": "Aさん"
        },
        {
          "user_code": "0000000002",
          "name": "Bさん"
        }
      ]
    }
  ],
  "meta": {
  }
}
Copy

ノート削除

DELETE /api/v1/notes/:note_code HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
なし
Copy

Response

HTTP/1.1 204 No Content
Copy

アーカイブ

PATCH /api/v1/notes/:note_code/archive HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
なし
Copy

Response

HTTP/1.1 204 No Content
Copy

アーカイブ戻し

PATCH /api/v1/notes/:note_code/extract HTTP/1.1
Copy

Request

パラメータ 内容 必須 デフォルト値 最大値
なし
Copy

Response

HTTP/1.1 204 No Content
Copy