Contents
ユーザープロフィールを取得する
トピックを共有したユーザーのステータスやオンライン情報といったプロフィールを取得します。
メソッド
GET
URL
https://typetalk.com/api/v2/spaces/:spaceKey/profile
スコープ
my
URL パラメーター
名前 | 型 | 説明 |
---|---|---|
spaceKey | 文字列 | スペースキー |
クエリパラメーター
名前 | 型 | 説明 |
---|---|---|
accountName (任意) | 文字列 | アカウント名 |
nulabId (任意) | 文字列 | Nulab ID |
レスポンスの例
{
"account": {
"id": 2488,
"name": "masa",
"fullName": "masa",
"suggestion": "masa",
"mailAddress": "example@nulab.com",
"imageUrl": "https://typetalk.com/accounts/2488/profile_image.png?t=1453868694472",
"createdAt": "2016-01-26T08:17:39Z",
"updatedAt": "2019-09-09T02:27:31Z",
"imageUpdatedAt": "2016-01-27T04:24:54Z"
},
"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 )