まとめを作成する

まとめを作成して、関連するメッセージをグループ化することができます。

メソッド

POST

URL

https://typetalk.com/api/v1/topics/:topicId/talks

スコープ

topic.post

URL パラメーター

名前 説明
topicId 数値 トピック ID

フォームパラメーター

名前 説明
talkName 文字列 まとめ名、最大文字数: 255
postIds[0], postIds[1] …. (任意) 数値 まとめに入れたい投稿 ID

レスポンスの例

{
  "topic": {
    "id": 208,
    "name": "IT Peeps",
    "description": "",
    "suggestion": "IT Peeps",
    "isDirectMessage": false,
    "lastPostedAt": "2016-12-21T10:12:02Z",
    "createdAt": "2014-06-10T02:32:29Z",
    "updatedAt": "2014-06-10T02:32:29Z"
  },
  "talk": {
    "id": 902,
    "topicId": 208,
    "name": "Feedback new design",
    "suggestion": "Feedback new design",
    "createdAt": "2016-12-21T10:12:22Z",
    "updatedAt": "2016-12-21T10:12:22Z",
    "backlog": null
  },
  "postIds": [
    300,
    301
  ]
}

レスポンスのフォーマットは全て JSON です。GET メソッドは ETag に対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は 304 を返します。日付のフォーマットは ISO 8601 で、UTC です。 (例 : 2014-01-09T06:20:08Z )