監査ログと操作

監査ログと操作

目的: プロバイダーのアクション、ジョブの実行、およびトラブルシューティングのための操作履歴をクエリします。

UI フロー

1. UI はアカウントごとに最新のログを読み込みます。
2. ユーザーはタスク/ジョブ/電子メール/資格情報イベントごとにログをフィルタリングします。
3. UI は、各ログの範囲指定された詳細ページを公開します。
4. UI は、最初に検索削除ドライランを使用して、古いログの制御されたクリーンアップを実行できます。

クライアント ライブラリ フロー

const logs = await api.logs.list(accountId, { limit: 50, offset: 0 });
const filtered = await api.logs.search(accountId, {
  query: "smtp_send_message",
  limit: 20,
});
if (filtered.data.length > 0) {
  await api.logs.get(filtered.data[0].id);
}

HTTP/カールフロー

API_BASE_URL="https://api.inbox-manager.com"

curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs?limit=20&offset=0" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"imap_fetch_body","limit":20,"offset":0}'

curl -sS "${API_BASE_URL}/api/logs/${LOG_ID}" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search-delete" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"debug","dry_run":true,"limit":100,"older_than":"2026-01-01T00:00:00.000Z"}'

注意事項

• ログはアカウントおよびアプリケーションの範囲に限定されます。
• セキュリティ ポリシーにより、ログから資格情報の平文が除外されます。
• search-deleteにはolder_thanが必要です。