Contents

メッセージを検索する

様々な条件でメッセージを検索します。

メソッド

POST

URL

https://typetalk.com/api/v3/search/posts

スコープ

topic.read

フォームパラメーター

NameTypeDescription
q文字列検索文字列
spaceKey文字列組織キー
topicIds (任意)数値検索対象のトピック。指定がなければ全てのトピックが対象。
hasAttachments (任意)真偽値添付ファイルを持っている投稿のみ検索。デフォルト値：false
accountIds (任意)数値アカウント ID
start (任意)数値検索開始位置
from (任意)日付時刻検索範囲の起点となる日付時刻
to (任意)日付時刻検索範囲の終点となる日付時刻
botExclusion (任意)真偽値ボットの投稿を検索結果から除外。デフォルト値：false

レスポンスの例

{
    "count": 32,
    "posts": [
        {
            "id": 11842896,
            "topicId": 53692,
            "topic": {
                "id": 53692,
                "name": "Awesome project",
                "suggestion": "Awesome project",
                "isDirectMessage": false,
                "lastPostedAt": "2017-10-12T06:20:40Z",
                "createdAt": "2017-09-27T09:43:29Z",
                "updatedAt": "2017-10-12T06:22:28Z"
            },
            "replyTo": null,
            "message": "It is sunny today.",
            "account": {
                "id": 50117,
                "name": "Michael",
                "fullName": "Michael Buck",
                "suggestion": "Michael Buck",
                "imageUrl": "https://typetalk.com/accounts/50117/profile_image.png?t=1504408579564",
                "isBot": false,
                "createdAt": "2017-09-01T01:55:05Z",
                "updatedAt": "2017-10-12T07:15:40Z"
            },
            "attachments": [],
            "links": [],
            "directMessage": null,
            "createdAt": "2017-10-12T06:20:20Z",
            "updatedAt": "2017-10-12T06:20:20Z"
        }
    ],
    "isLimited": false
}

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