API endpoints
Audit Logs API
Audit Logs API надає об’єднаний журнал організації з доменів identity, billing, ledger, MPC, authentication та administration.
Список audit logs
GET /api/v1/orgs/{orgId}/audit-logs
Необхідний scope: audit-logs:read
API key має бути авторизований для організації, визначеної в orgId.
Фільтри
| Parameter | Призначення |
|---|---|
sources | Фільтр за identity, billing, ledger, mpc, auth або admin |
actions | Фільтр за однією або кількома actions |
actorType, actorId | Вибір користувача, API key, адміністратора або іншого actor |
objectType | Фільтр за типом об’єкта |
ip | Фільтр за client IP |
createdFrom, createdTo | Обмеження діапазону часу |
snapshotAt | Фіксація вікна результатів для стабільної pagination |
sortOrder | Порядок результатів |
page, limit | Page-based pagination |
Використовуйте те саме значення snapshotAt під час переходу між сторінками, щоб нові записи не зміщували межі сторінок.
Запис аудиту
Items містять source, actor identity, організацію, action, object, IP, user agent, результат автентифікації або причину failure та createdAt. Об’єднаний public response не містить source payloads.
Зберігання
Зберігайте API requestId під час реєстрації помилок. Експортуйте audit data відповідно до власних вимог до зберігання та регуляторних вимог; доступність API не замінює політику збереження доказів вашої організації.