Saltar para o conteúdo principal
POST
Emitir Evento
Emite um evento de observabilidade estruturado para o fluxo de eventos MAIP. Os eventos fornecem um registro de auditoria unificado de todas as ações significativas no serviço de identidade de máquina — desde o registro do agente e o ciclo de vida da sessão até o cálculo de confiança e a conclusão da orquestração. Os eventos são persistidos com isolamento de inquilino, indexados para consulta rápida e disponíveis para entrega de webhook, integração SIEM e pipeline de agregação de métricas.

Tipos de Eventos

O campo event_type usa um namespace separado por pontos. Os seguintes tipos de evento são suportados:

Resposta

string
Identificador de evento único no formato MAIP (maip-evt:ULID).
string
O tipo de evento emitido.
string
Identificador de agente associado.
string
Identificador de recurso associado.
string
Nível de gravidade do evento.
string
Carimbo de data/hora de criação do evento ISO 8601.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
actor_id
string
obrigatório
actor_type
string
obrigatório
event_type
string
obrigatório

Identificador de tipo de evento separado por ponto (por exemplo, agent.registered, orchestration.completed)

payload
any
source_service
string
span_id
string | null
target_id
string | null
target_type
string | null
trace_id
string | null

Resposta

Evento emitido com sucesso

id
string

Identificador de evento único (maip-evt:ULID)

event_type
string
agent_id
string
resource_id
string
severity
string
created_at
string<date-time>