Contents
ユーザーステータスを取得する
トピックを共有したユーザーのユーザーステータス情報を取得します。
メソッド
POST
URL
https://typetalk.com/api/v2/spaces/:spaceKey/accounts/status
スコープ
my
URL パラメーター
名前 | 型 | 説明 |
---|---|---|
spaceKey | 文字列 | スペースキー |
フォームパラメーター
名前 | 型 | 説明 |
---|---|---|
accountIds (複数指定可) | 数値 | アカウント ID(トピックのメンバーのみ) |
レスポンスの例
{
"accounts": [
{
"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": "2019-09-09T02:27:31Z"
},
"status": {
"presence": "away",
"web": null,
"mobile": null
},
"userStatus": {
"id": 129,
"accountId": 2488,
"spaceId": 29,
"emoji": ":spiral_note_pad:",
"message": "ミーティング中",
"clearAt": "2019-09-09T02:58:00Z",
"isNotificationDisabled": true,
"createdAt": "2019-09-03T01:37:34Z",
"updatedAt": "2019-09-09T02:28:00Z"
}
}
]
}
レスポンスのフォーマットは全て JSON です。GET メソッドは ETag に対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は 304 を返します。日付のフォーマットは ISO 8601 で、UTC です。 (例 : 2014-01-09T06:20:08Z )