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

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

メソッド

GET

URL

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

スコープ

my

クエリパラメーター

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

レスポンスの例

{
    "topics": [
        {
            "topic": {
                "id": 6249,
                "name": "yoshi,masanori",
                "suggestion": "yoshi,masanori",
                "isDirectMessage": true,
                "isArchived": false,
                "lastPostedAt": "2019-04-17T10:11:13Z",
                "createdAt": "2018-09-25T06:28:07Z",
                "updatedAt": "2018-09-25T06:28:07Z"
            },
            "unread": {
                "topicId": 6249,
                "postId": 172968,
                "count": 0,
                "isOverCountLimit": false
            },
            "directMessage": {
                "account": {
                    "id": 2489,
                    "name": "yoshizawa",
                    "fullName": "Yoshi",
                    "suggestion": "Yoshi",
                    "imageUrl": "https://typetalk.com/accounts/2489/profile_image.png?t=1564389095614",
                    "isBot": false,
                    "createdAt": "2016-01-26T08:18:12Z",
                    "updatedAt": "2019-09-09T02:38:15Z"
                },
                "status": {
                    "presence": "active",
                    "web": {},
                    "mobile": null
                },
                "userStatus": {
                    "id": 131,
                    "accountId": 2489,
                    "spaceId": 29,
                    "emoji": ":train:",
                    "message": "移動中",
                    "clearAt": "2019-09-09T03:38:00Z",
                    "isNotificationDisabled": false,
                    "createdAt": "2019-09-09T02:38:26Z",
                    "updatedAt": "2019-09-09T02:38:26Z"
                }
            }
        }
    ]
}

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