Contents

メッセージ詳細を取得する

トピックに投稿された特定のメッセージを取得します。

メソッド

GET

URL

https://typetalk.com/api/v1/topics/:topicId/posts/:postId

スコープ

topic.read

URL パラメーター

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

レスポンスの例

{
    "mySpace": {
        "space": {
            "key": "xxxxx",
            "name": "Nulab Inc",
            "enabled": true,
            "imageUrl": "https://apps.nulab.com/spaces/xxxxxx/photo/large"
        },
        "myRole": "ADMIN",
        "isPaymentAdmin": true,
        "invitableRoles": [
            "ADMIN",
            "USER",
            "GUEST"
        ],
        "myPlan": {
            "plan": {
                "key": "typetalk.standard25",
                "name": "スタンダード 25 ユーザー",
                "limitNumberOfUsers": 25,
                "limitNumberOfAllowedAddresses": 25,
                "limitTotalAttachmentSize": 26843545600
            },
            "enabled": true,
            "trial": null,
            "numberOfUsers": 5,
            "numberOfAllowedAddresses": 0,
            "totalAttachmentSize": 39932,
            "createdAt": "2016-01-19T09:29:10Z",
            "updatedAt": "2018-11-07T02:01:42Z"
        }
    },
    "team": null,
    "topic": {
        "id": 3557,
        "name": "サイト改善",
        "suggestion": "サイト改善",
        "isDirectMessage": false,
        "lastPostedAt": "2018-11-07T02:05:38Z",
        "createdAt": "2016-02-05T06:13:44Z",
        "updatedAt": "2018-10-18T01:54:18Z",
        "description": "UXの改善に関するトピックです。\nデザインやUX、その他気づいた点について気軽に話しましょう。\n\nサイト改善についてのまとめWiki\n- https://xxxxx.backlog.jp/wiki/WEBSITE/Kaizen\n\nまた、関連イベントの周知もこのトピックで行います。"
    },
    "post": {
        "id": 167968,
        "topicId": 3557,
        "replyTo": 154016,
        "message": "@masa 画像ファイルを添付しますー \nhttps://nulab.com/ja/",
        "account": {
            "id": 2489,
            "name": "agata",
            "fullName": "Toshitaka Agata",
            "suggestion": "Toshitaka Agata",
            "imageUrl": "https://typetalk.com/accounts/2489/profile_image.png?t=1453867573519",
            "isBot": false,
            "createdAt": "2016-01-26T08:18:12Z",
            "updatedAt": "2018-11-07T02:06:17Z"
        },
        "mention": {
            "id": 16896,
            "readAt": "2018-11-07T02:06:38Z"
        },
        "attachments": [
            {
                "attachment": {
                    "contentType": "image/png",
                    "fileKey": "d8c6f3b46fde39eee1ea3f1184fb1ac2cc3e3790",
                    "fileName": "Jenkins.png",
                    "fileSize": 39932
                },
                "webUrl": "https://typetalk.com/topics/3557/posts/167968/attachments/1/Jenkins.png",
                "apiUrl": "https://typetalk.com/api/v1/topics/3557/posts/167968/attachments/1/Jenkins.png",
                "thumbnails": [
                    {
                        "type": "small",
                        "fileSize": 21455,
                        "width": 185,
                        "height": 256
                    },
                    {
                        "type": "medium",
                        "fileSize": 21455,
                        "width": 185,
                        "height": 256
                    },
                    {
                        "type": "large",
                        "fileSize": 21455,
                        "width": 185,
                        "height": 256
                    }
                ]
            }
        ],
        "likes": [
            {
                "id": 20011,
                "postId": 167968,
                "topicId": 3557,
                "comment": "",
                "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-07T02:06:34Z"
                },
                "createdAt": "2018-11-07T02:06:41Z"
            }
        ],
        "talks": [
            {
                "id": 2200,
                "topicId": 3557,
                "name": "プレゼン用資料",
                "suggestion": "プレゼン用資料",
                "createdAt": "2018-11-07T02:04:17Z",
                "updatedAt": "2018-11-07T02:04:17Z",
                "backlog": null
            }
        ],
        "links": [
            {
                "id": 3568,
                "url": "https://nulab.com/ja/",
                "contentType": "text/html; charset=UTF-8",
                "title": "チームにさらなるコラボレーションを | ヌーラボ",
                "description": "数百万人ものユーザーがヌーラボのサービスを使用して、チームのコミュニケーションを改善しています。ヌーラボのオンラインコラボレーションツールで、あなたのチームの仕事をもっと楽しくしましょう。",
                "imageUrl": "https://d19ta9rijs3cxg.cloudfront.net/wp-content/uploads/sites/2/2018/05/ogp_dft1.png",
                "embed": null,
                "createdAt": "2018-11-07T02:05:39Z",
                "updatedAt": "2018-11-07T02:05:39Z"
            }
        ],
        "createdAt": "2018-11-07T02:01:42Z",
        "updatedAt": "2018-11-07T02:05:38Z"
    },
    "replies": [
        {
            "id": 154013,
            "topicId": 3557,
            "replyTo": null,
            "message": "ありがとうございます。グリーン系で統一してみました。",
            "account": {
                "id": 2492,
                "name": "hayashi",
                "fullName": "hayashi",
                "suggestion": "hayashi",
                "imageUrl": "https://typetalk.com/accounts/2492/profile_image.png?t=1453871047310",
                "isBot": false,
                "createdAt": "2016-01-26T08:19:01Z",
                "updatedAt": "2018-11-06T01:48:44Z"
            },
            "mention": null,
            "attachments": [],
            "likes": [],
            "talks": [
                {
                    "id": 2178,
                    "topicId": 3557,
                    "name": "文字サイズの変更",
                    "suggestion": "文字サイズの変更",
                    "createdAt": "2017-12-18T07:13:48Z",
                    "updatedAt": "2018-10-25T01:35:25Z",
                    "backlog": {
                        "spaceUrl": "https://xxxx.backlog.jp",
                        "issueKey": "KAIZEN-16"
                    }
                }
            ],
            "links": [],
            "createdAt": "2016-02-05T00:13:44Z",
            "updatedAt": "2016-02-05T00:13:44Z"
        },
        {
            "id": 154014,
            "topicId": 3557,
            "replyTo": 154013,
            "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-07T02:06:34Z"
            },
            "mention": null,
            "attachments": [],
            "likes": [
                {
                    "id": 18919,
                    "postId": 154014,
                    "topicId": 3557,
                    "comment": "",
                    "account": {
                        "id": 2489,
                        "name": "agata",
                        "fullName": "Toshitaka Agata",
                        "suggestion": "Toshitaka Agata",
                        "imageUrl": "https://typetalk.com/accounts/2489/profile_image.png?t=1453867573519",
                        "isBot": false,
                        "createdAt": "2016-01-26T08:18:12Z",
                        "updatedAt": "2018-11-07T02:06:17Z"
                    },
                    "createdAt": "2016-04-14T07:58:06Z"
                }
            ],
            "talks": [
                {
                    "id": 2178,
                    "topicId": 3557,
                    "name": "文字サイズの変更",
                    "suggestion": "文字サイズの変更",
                    "createdAt": "2017-12-18T07:13:48Z",
                    "updatedAt": "2018-10-25T01:35:25Z",
                    "backlog": {
                        "spaceUrl": "https://xxxx.backlog.jp",
                        "issueKey": "KAIZEN-16"
                    }
                }
            ],
            "links": [],
            "createdAt": "2016-02-05T01:13:44Z",
            "updatedAt": "2016-02-05T01:13:44Z"
        },
        {
            "id": 154015,
            "topicId": 3557,
            "replyTo": 154014,
            "message": "確かに読みにくいですね。もう少しサイズを大きくしてみます:smile:",
            "account": {
                "id": 2490,
                "name": "tabata",
                "fullName": "Shinsuke Tabata",
                "suggestion": "Shinsuke Tabata",
                "imageUrl": "https://typetalk.com/accounts/2490/profile_image.png?t=1453863100614",
                "isBot": false,
                "createdAt": "2016-01-26T08:18:29Z",
                "updatedAt": "2018-11-06T01:48:44Z"
            },
            "mention": null,
            "attachments": [],
            "likes": [],
            "talks": [
                {
                    "id": 2178,
                    "topicId": 3557,
                    "name": "文字サイズの変更",
                    "suggestion": "文字サイズの変更",
                    "createdAt": "2017-12-18T07:13:48Z",
                    "updatedAt": "2018-10-25T01:35:25Z",
                    "backlog": {
                        "spaceUrl": "https://xxxx.backlog.jp",
                        "issueKey": "KAIZEN-16"
                    }
                }
            ],
            "links": [],
            "createdAt": "2016-02-05T01:13:44Z",
            "updatedAt": "2016-02-05T01:13:44Z"
        },
        {
            "id": 154016,
            "topicId": 3557,
            "replyTo": 154015,
            "message": "ところで、今週末のイベントの案だけど、もうできていますか?",
            "account": {
                "id": 2489,
                "name": "agata",
                "fullName": "Toshitaka Agata",
                "suggestion": "Toshitaka Agata",
                "imageUrl": "https://typetalk.com/accounts/2489/profile_image.png?t=1453867573519",
                "isBot": false,
                "createdAt": "2016-01-26T08:18:12Z",
                "updatedAt": "2018-11-07T02:06:17Z"
            },
            "mention": null,
            "attachments": [],
            "likes": [
                {
                    "id": 18859,
                    "postId": 154016,
                    "topicId": 3557,
                    "comment": null,
                    "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-07T02:06:34Z"
                    },
                    "createdAt": "2016-02-05T06:13:44Z"
                },
                {
                    "id": 18860,
                    "postId": 154016,
                    "topicId": 3557,
                    "comment": null,
                    "account": {
                        "id": 2489,
                        "name": "agata",
                        "fullName": "Toshitaka Agata",
                        "suggestion": "Toshitaka Agata",
                        "imageUrl": "https://typetalk.com/accounts/2489/profile_image.png?t=1453867573519",
                        "isBot": false,
                        "createdAt": "2016-01-26T08:18:12Z",
                        "updatedAt": "2018-11-07T02:06:17Z"
                    },
                    "createdAt": "2016-02-05T06:13:44Z"
                },
                {
                    "id": 18861,
                    "postId": 154016,
                    "topicId": 3557,
                    "comment": null,
                    "account": {
                        "id": 2490,
                        "name": "tabata",
                        "fullName": "Shinsuke Tabata",
                        "suggestion": "Shinsuke Tabata",
                        "imageUrl": "https://typetalk.com/accounts/2490/profile_image.png?t=1453863100614",
                        "isBot": false,
                        "createdAt": "2016-01-26T08:18:29Z",
                        "updatedAt": "2018-11-06T01:48:44Z"
                    },
                    "createdAt": "2016-02-05T06:13:44Z"
                },
                {
                    "id": 18862,
                    "postId": 154016,
                    "topicId": 3557,
                    "comment": null,
                    "account": {
                        "id": 2491,
                        "name": "nakamura",
                        "fullName": "ikikko",
                        "suggestion": "ikikko",
                        "imageUrl": "https://typetalk.com/accounts/2491/profile_image.png?t=1453873118352",
                        "isBot": false,
                        "createdAt": "2016-01-26T08:18:46Z",
                        "updatedAt": "2018-11-06T01:48:44Z"
                    },
                    "createdAt": "2016-02-05T06:13:44Z"
                },
                {
                    "id": 18863,
                    "postId": 154016,
                    "topicId": 3557,
                    "comment": null,
                    "account": {
                        "id": 2492,
                        "name": "hayashi",
                        "fullName": "hayashi",
                        "suggestion": "hayashi",
                        "imageUrl": "https://typetalk.com/accounts/2492/profile_image.png?t=1453871047310",
                        "isBot": false,
                        "createdAt": "2016-01-26T08:19:01Z",
                        "updatedAt": "2018-11-06T01:48:44Z"
                    },
                    "createdAt": "2016-02-05T06:13:44Z"
                }
            ],
            "talks": [],
            "links": [],
            "createdAt": "2016-02-05T05:33:44Z",
            "updatedAt": "2016-02-05T05:33:44Z"
        }
    ],
    "exceedsAttachmentLimit": false,
    "isPostEnabled": true
}

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