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 )