重要メール設定
特定のメールを"重要なメール"として指定します。
注意
- mailSNList パラメータで複数のメールを指定した際、一部のメールが存在しない場合でも、成功(200) が返ります。
- status パラメータに mark もしくは unmark 以外の値を指定した場合、全て unmark として処理されます。
API の種類
サービス API
Request URL
https://apis.worksmobile.com/r/{API ID}/mail/v2/setMarkStatus
HTTP Method
PUT(Content-Type: application/x-www-form-urlencoded; charset=UTF-8)
Request
パラメータ | タイプ | 必須 | 説明 |
---|---|---|---|
mailSNList | String | Y | メールリスト。シリアルナンバー(mailSN)をセミコロン(;)でつなげた値。 例) 46554;46548;46550 |
status | String | Y | 設定値。 ● mark: 重要なメール ● unmark: 一般メール |
Request Example
https://apis.worksmobile.com/r/{API ID}/mail/v2/setMarkStatus?mailSNList=2461&status=mark
Response
呼び出しに成功すると HTTP Status コード 200 のみを返します。レスポンス内容は含みません。
Error
呼び出しに失敗すると、HTTP Status と以下のエラー情報を返します。
プロパティ | タイプ | 説明 |
---|---|---|
code | String | Error Code |
message | String | Error Message |
HTTP Status | Error Code | 説明 |
---|---|---|
400 | INVALID_PARAMETER | リクエスト値が不適切 |
404 | NOT_EXIST_MAILSN | 指定したメールが存在しない |
500 | SYSTEM_ERROR | 内部サーバーエラー |
Error Example
{
"code": "NOT_EXIST_MAILSN",
"domain": "mail",
"message": "MailSn does not exist."
}