ユーザーステータスを保存
メソッド
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 )