Contents

トピック一覧を取得する

組織に参加しているすべてのトピックを取得します。

メソッド

GET

URL

https://typetalk.com/api/v3/topics

スコープ

my

クエリパラメーター

名前説明
spaceKey文字列組織キー
isArchived (任意)真偽値アーカイブトピックかどうか。未指定の場合はすべてのトピック。
onlyEditable (任意)真偽値編集・削除権限のあるトピックかどうか。未指定の場合はすべてのトピック。

レスポンスの例

{
    "topics": [
        {
            "topic": {
                "id": 6310,
                "name": "ディレクション",
                "suggestion": "ディレクション",
                "isDirectMessage": false,
                "isArchived": false,
                "lastPostedAt": "2019-07-29T10:06:14Z",
                "ownerSpaceAccountId": 103,
                "createdAt": "2018-10-18T01:43:31Z",
                "updatedAt": "2018-10-18T01:43:31Z"
            },
            "unread": {
                "topicId": 6310,
                "postId": 174993,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 6233,
                "name": "デザイン",
                "suggestion": "デザイン",
                "isDirectMessage": false,
                "isArchived": false,
                "lastPostedAt": "2019-07-17T10:34:29Z",
                "ownerSpaceAccountId": 103,
                "createdAt": "2018-09-19T06:00:20Z",
                "updatedAt": "2018-09-19T06:00:20Z"
            },
            "unread": {
                "topicId": 6233,
                "postId": 175719,
                "count": 0,
                "isOverCountLimit": false
            }
        }
    ]
}

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