ユーザーステータスを保存

メソッド

POST

URL

https://typetalk.com/api/v1/spaces/:spaceKey/userStatuses

スコープ

my

URLパラメーター

名前 説明
spaceKey 文字列 スペースキー

フォームパラメーター

名前 説明
emoji 文字列 ステータス絵文字(絵文字記法の文字列)
message (任意) 文字列 ステータスメッセージ
clearAt (任意) 文字列 ステータスの有効期限
isNotificationDisabled (任意) 真偽値 通知を停止(デフォルト: false)

レスポンスの例

{
    "userStatus": {
        "id": 129,
        "accountId": 2488,
        "spaceId": 29,
        "emoji": ":spiral_note_pad:",
        "message": "ミーティング",
        "clearAt": "2019-09-06T10:49:00Z",
        "isNotificationDisabled": true,
        "createdAt": "2019-09-03T01:37:34Z",
        "updatedAt": "2019-09-06T10:34:46Z"
    }
}

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