アカウントIDとイベント名を指定して管理画面におけるユーザーごとの操作履歴一覧を取得する。
開始番号と終了番号の指定は任意。指定がなければデフォルト値が入る。
開始番号は1以上、終了番号は開始番号以上の数値となる。
一度に取得可能な操作履歴数は1000件まで。
リクエスト
エンドポイント
/v1/audits/[id]/[event_type]?from=[開始番号]&to=[終了番号]
HTTPメソッド
GET
リクエストボディ
なし
リクエストパラメータ
|
パラメータ名 |
説明 |
|---|---|
| id | アカウントID |
| event_type | イベント名・現状の対応イベントは下記 |
イベント名
|
要素名 |
説明 |
|---|---|
| login | 管理画面へのログイン試行 |
| account_lock | アカウントロックの発生 |
クエリパラメータ
|
クエリ名 |
デフォルト値 |
説明 |
|---|---|---|
| from | 1 | 指定は任意 |
| to | 取得可能な最大値 | 指定は任意 |
レスポンス
ステータスコード
|
状態 |
コード |
|---|---|
| 成功 | 200 |
| バリデーションエラー | 400 |
| 認証失敗 | 401 |
| 存在しないエンドポイント | 404 |
| 許可されていないHTTPメソッド | 405 |
| システムエラーが発生した | 500 |
| システムが一時的にサービスを提供できない状態になっている | 503 |
| システムのタイムアウト | 504 |
レスポンスボディ
|
要素名 |
型 |
要素数 |
説明 |
|---|---|---|---|
| code | 数値 | 1 | ステータスコード |
| data | 操作履歴型の配列 | 0:* |
操作履歴
|
要素名 |
型 |
要素数 |
説明 |
|---|---|---|---|
| account_id | 数値 | 1 | アカウントID |
| event_type | 文字列 | 1 | イベント名 |
| succeeded | 真偽値 | 1 |
イベントの成否 |
| ip_address | 文字列 | 1 | イベント発生時の接続IPアドレス |
| created | 文字列 | 1 | イベント発生日時 |
| account_name | 文字列 | 1 | アカウント名 |