ダイレクトメッセージトピック一覧の取得

ダイレクトメッセージをすでに送ったことがあるユーザーとのダイレクトメッセージトピック一覧を取得します。 JSON に含まれる “directMessage” プロパティから相手のアカウントとオンラインステータス情報が取得できます。 オンラインステータスのみ取得したい場合はオンラインステータスの取得を参照してください。

メソッド

GET

URL

https://typetalk.com/api/v2/messages

スコープ

my

クエリパラメーター

名前 説明
spaceKey 文字列 組織のキー

レスポンスの例

{
    "topics": [
        {
            "topic": {
                "id": 26094,
                "name": "Moss,Jessica",
                "suggestion": "Moss,Jessica",
                "isDirectMessage": true,
                "isArchived": false,
                "lastPostedAt": "2019-08-30T10:21:27Z",
                "createdAt": "2019-08-30T10:21:27Z",
                "updatedAt": "2019-08-30T10:21:27Z"
            },
            "unread": {
                "topicId": 26094,
                "postId": 176258,
                "count": 0,
                "isOverCountLimit": false
            },
            "directMessage": {
                "account": {
                    "id": 2499,
                    "name": "Moss",
                    "fullName": "Moss",
                    "suggestion": "Moss",
                    "imageUrl": "https://typetalk.com/accounts/1234567890/profile_image.png?t=1453891379196",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:23Z",
                    "updatedAt": "2019-09-04T06:57:51Z"
                },
                "status": {
                    "presence": "away",
                    "web": null,
                    "mobile": null
                }
            }
        },
        {
            "topic": {
                "id": 3917,
                "name": "Jessica,StefHull",
                "suggestion": "Jessica,StefHull",
                "isDirectMessage": true,
                "isArchived": false,
                "lastPostedAt": "2018-11-26T01:09:12Z",
                "createdAt": "2016-07-06T02:51:03Z",
                "updatedAt": "2016-08-17T08:30:58Z"
            },
            "unread": {
                "topicId": 3917,
                "postId": 168196,
                "count": 0,
                "isOverCountLimit": false
            },
            "directMessage": {
                "account": {
                    "id": 2498,
                    "name": "Stefanie",
                    "fullName": "Stefanie",
                    "suggestion": "Stefanie",
                    "imageUrl": "https://typetalk.com/accounts/1234567891/profile_image.png?t=1453891479138",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:09Z",
                    "updatedAt": "2019-09-04T06:57:51Z"
                },
                "status": {
                    "presence": "away",
                    "web": null,
                    "mobile": null
                }
            }
        }
    ]
}

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