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 ）