Contents
まとめがついているメッセージを取得する
指定したまとめがついているメッセージを取得します。
メソッド
GET
URL
https://typetalk.com/api/v1/topics/:topicId/talks/:talkId/posts
スコープ
topic.read
URL パラメーター
| 名前 | 型 | 説明 |
|---|---|---|
| topicId | 数値 | トピック ID |
| talkId | 数値 | まとめ ID |
クエリパラメーター
| 名前 | 型 | 説明 |
|---|---|---|
| count (任意) | 数値 | デフォルト値: 20、最大値: 100 |
| from (任意) | 数値 | 投稿 ID |
| direction (任意) | 文字列 | ”backward” または “forward” |
レスポンスの例
{
"mySpace": {
"space": {
"key": "abcdefghij",
"name": "Joe Tech Inc.",
"enabled": true,
"imageUrl": "https://apps.nulab.com/spaces/abcdefghij/photo/large"
},
"myRole": "ADMIN",
"isPaymentAdmin": true,
"myPlan": {
"plan": {
"key": "typetalk.free",
"name": "Free Plan",
"limitNumberOfUsers": 10,
"limitTotalAttachmentSize": 1073741824
},
"enabled": true,
"trial": null,
"numberOfUsers": 6,
"totalAttachmentSize": 0,
"createdAt": "2016-01-10T02:32:29Z",
"updatedAt": "2016-12-21T10:12:18Z"
}
},
"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"
},
"directMessage": null,
"talk": {
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
},
"posts": [
{
"id": 305,
"topicId": 208,
"replyTo": null,
"message": "And I'm a 32 year old IT-man who works in a basement. Word.",
"account": {
"id": 104,
"name": "cooper",
"fullName": "CooperDaChopper",
"suggestion": "CooperDaChopper",
"imageUrl": "https://typetalk.com/accounts/104/profile_image.png?t=1403922749000",
"isBot": false,
"createdAt": "2014-06-28T02:32:29Z",
"updatedAt": "2014-06-28T02:32:29Z"
},
"mention": null,
"attachments": [],
"likes": [],
"talks": [
{
"id": 901,
"topicId": 208,
"name": "2nd talk",
"suggestion": "2nd talk",
"createdAt": "2014-07-02T03:52:29Z",
"updatedAt": "2014-07-02T03:55:29Z",
"backlog": null
},
{
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
}
],
"links": [],
"createdAt": "2014-06-30T14:32:29Z",
"updatedAt": "2014-06-30T14:32:29Z"
},
{
"id": 306,
"topicId": 208,
"replyTo": 305,
"message": "Oh. What time of the month? The weekend?",
"account": {
"id": 100,
"name": "jessica",
"fullName": "Jessica Fitzherbert",
"suggestion": "Jessica Fitzherbert",
"imageUrl": "https://typetalk.com/accounts/100/profile_image.png?t=1403577149000",
"isBot": false,
"createdAt": "2014-06-24T02:32:29Z",
"updatedAt": "2014-06-24T02:32:29Z"
},
"mention": null,
"attachments": [],
"likes": [
{
"id": 403,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 101,
"name": "ahorowitz",
"fullName": "AHorowitz",
"suggestion": "AHorowitz",
"imageUrl": "https://typetalk.com/accounts/101/profile_image.png?t=1403663549000",
"isBot": false,
"createdAt": "2014-06-25T02:32:29Z",
"updatedAt": "2014-06-25T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 404,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 102,
"name": "moss",
"fullName": "Moss",
"suggestion": "Moss",
"imageUrl": "https://typetalk.com/accounts/102/profile_image.png?t=1403749949000",
"isBot": false,
"createdAt": "2014-06-26T02:32:29Z",
"updatedAt": "2014-06-26T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 405,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 103,
"name": "stefhull",
"fullName": "StefHull",
"suggestion": "StefHull",
"imageUrl": "https://typetalk.com/accounts/103/profile_image.png?t=1403836349000",
"isBot": false,
"createdAt": "2014-06-27T02:32:29Z",
"updatedAt": "2014-06-27T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 406,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 104,
"name": "cooper",
"fullName": "CooperDaChopper",
"suggestion": "CooperDaChopper",
"imageUrl": "https://typetalk.com/accounts/104/profile_image.png?t=1403922749000",
"isBot": false,
"createdAt": "2014-06-28T02:32:29Z",
"updatedAt": "2014-06-28T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 407,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 105,
"name": "brad",
"fullName": "BradMarshalls",
"suggestion": "BradMarshalls",
"imageUrl": "https://typetalk.com/accounts/105/profile_image.png?t=1404009149000",
"isBot": false,
"createdAt": "2014-06-29T02:32:29Z",
"updatedAt": "2014-06-29T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
}
],
"talks": [
{
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
}
],
"links": [],
"createdAt": "2014-07-01T01:32:29Z",
"updatedAt": "2014-07-01T01:32:29Z"
}
],
"hasNext": false
}
レスポンスのフォーマットは全て JSON です。GET メソッドは ETag に対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は 304 を返します。日付のフォーマットは ISO 8601 で、UTC です。 （例 : 2014-01-09T06:20:08Z ）