メモの投稿API
```
POST /teams/:domain/posts
```

指定したドメインのチームに新しいメモを投稿します。

### スコープ
`作成`

### リクエストパラメータ

#### 全員が使用可能なパラメータ

| パラメータ | 内容 | 型 | 必須 | デフォルト値 |
| --- | --- | --- | :---: | :---: |
| title | メモのタイトル | String | 必須 |  |
| body | メモの本文 | String |  | |
| draft | 下書き保存にするかどうか | Boolean |  | false |
| notice | 通知するかどうか | Boolean |  | true |
| tags | タグ名の配列 | String Array | |  |
| scope | [公開範囲](#公開範囲) | String |  | private |
| groups | グループID配列 | Integer Array | scopeがgroupの時のみ必須 | |
| exclude_body | レスポンスにメモの本文を含めないか | Boolean |  | false |

#### オーナーもしくは管理者のみが使用可能なパラメータ

APIの利用者がチームのオーナー、もしくは管理者の場合は、次のパラメータも使用可能です。
投稿者のIDを指定して、チームの他のメンバーが投稿したメモとして投稿できます。
投稿日時を指定して、その時刻に投稿されたメモとして投稿できます。

| パラメータ | 内容 | 型 | 条件 | デフォルト値 |
| --- | --- | --- | :---: | :---: |
| author_id | 投稿者のID | Integer | draftがfalseかつscopeがprivate以外の場合のみ指定可能 |  |
| published_at | 投稿日時 | DateTime<br>（ISO-8601） | draftがfalseの場合のみ指定可能 |  |

#### 公開範囲

scopeパラメータには下記の値を指定できます。

| 値 | 公開範囲 |
| --- | --- |
| group | groupsパラメータで指定したグループ |
| private | 自分のみ |
| everyone | チーム全体 |

### cURLでのリクエスト例

```sh
curl \
  -H 'X-DocBaseToken: ACCESS TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
         "title": "メモのタイトル",
         "body": "メモの本文",
         "draft": false,
         "tags": ["rails", "ruby"],
         "scope": "group",
         "groups": [1],
         "notice": true
       }' \
  https://api.docbase.io/teams/kray/posts
```

### レスポンス例
[メモ詳細のレスポンス例](https://kray.docbase.io/posts/96794)と同一となります。