メッセージを投稿する
トピックにメッセージを投稿します。
メソッド
POST
URL
https://typetalk.com/api/v1/topics/:topicId
スコープ
topic.post
URL パラメーター
| 名前 | 型 | 説明 |
|---|---|---|
| topicId | 数値 | トピック ID |
フォームパラメーター
| 名前 | 型 | 説明 |
|---|---|---|
| message | 文字列 | 投稿するメッセージ。最大 4000 文字 |
| replyTo (任意) | 数値 | 返信先の postId |
| showLinkMeta (任意) | 真偽値 | メッセージに含まれる URL の OGP 情報の表示設定。デフォルト値: true |
| ignoreHashtag (任意) | 真偽値 | 投稿のハッシュタグ機能を無効化。デフォルト値：false |
| fileKeys[0] … fileKeys[4] (任意) | 文字列 | 添付ファイルキー （添付ファイルのアップロード 参照）(最大 5 個まで） |
| talkIds[0] … talkIds[4] (任意) | 数値 | この投稿を追加したいまとめ ID (最大 5 個まで) |
| attachments[0].fileUrl … attachments[4].fileUrl (任意) | 文字列 | 最大 5 個のファイル URL (最大ファイルサイズ: 10 MB) |
| attachments[0].fileName … attachments[4].fileName (任意) | 文字列 | パラメーターがない場合は ‘fileUrl’ からファイル名が設定 (最大 5 個まで） |
レスポンスの例
{
"space": {
"key": "xxxxxx",
"name": "Nulab Inc",
"enabled": true,
"imageUrl": "https://apps.nulab.com/spaces/xxxxxx/photo/large"
},
"topic": {
"id": 3559,
"name": "デザイナー",
"suggestion": "デザイナー",
"isDirectMessage": false,
"lastPostedAt": "2018-11-06T07:40:02Z",
"createdAt": "2016-02-05T06:13:44Z",
"updatedAt": "2018-09-19T06:00:09Z",
"description": ""
},
"post": {
"id": 167963,
"topicId": 3559,
"replyTo": null,
"message": "ボタンの画像ってどこでしたっけ？",
"account": {
"id": 2488,
"name": "masa",
"fullName": "masa",
"suggestion": "masa",
"imageUrl": "https://typetalk.com/accounts/2488/profile_image.png?t=1453868694472",
"isBot": false,
"createdAt": "2016-01-26T08:17:39Z",
"updatedAt": "2018-11-06T07:35:56Z"
},
"mention": null,
"attachments": [],
"likes": [],
"talks": [],
"links": [],
"createdAt": "2018-11-06T07:40:02Z",
"updatedAt": "2018-11-06T07:40:02Z"
},
"mentions": [],
"exceedsAttachmentLimit": false,
"directMessage": null
}
レスポンスのフォーマットは全て JSON です。GET メソッドは ETag に対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は 304 を返します。日付のフォーマットは ISO 8601 で、UTC です。 （例 : 2014-01-09T06:20:08Z ）