Saltar para o conteúdo principal
POST
Criar Verificação de Conformidade
Executa uma avaliação de conformidade automatizada para uma entidade específica (agente, modelo, conjunto de dados ou fluxo de trabalho) contra uma regulamentação suportada. A verificação avalia a configuração da entidade, padrões de acesso, tratamento de dados e trilha de auditoria em relação aos requisitos da regulamentação e produz uma determinação de conformidade com descobertas detalhadas. As verificações de conformidade são idempotentes para o mesmo par entidade-regulamentação dentro de uma janela de 24 horas. Chamadas repetidas dentro dessa janela retornam o resultado em cache.

Autenticação

Requer cabeçalho X-API-Key ou token JWT de portador. O espaço de trabalho é derivado da credencial autenticada; não envie X-Tenant-ID.

Resposta

string
Identificador único para o registro de verificação de conformidade. Formato: maip-cc:ULID.
string
O tipo de entidade que foi avaliada.
string
O identificador da entidade avaliada.
string
A regulamentação que foi avaliada.
string
O escopo da avaliação. full se nenhum escopo foi especificado.
string
A determinação de conformidade. Uma de: - compliant — a entidade atende a todos requisitos avaliados - non_compliant — entidade falha em um ou mais requisitos críticos requisitos - partial — a entidade atende a alguns, mas não a todos os requisitos
object[]
Lista detalhada de descobertas individuais da avaliação.
string
O recibo MAIP emitido para esta verificação de conformidade, fornecendo um registro de auditoria.
string
Carimbo de data/hora ISO 8601 de quando a avaliação foi realizada.

Regulamentações Suportadas

Autorizações

X-API-Key
string
header
obrigatório

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

Corpo

application/json
auditor_id
string
obrigatório
entity_id
string
obrigatório
regulation
string
obrigatório
requirement_id
string
obrigatório
result
string
obrigatório
check_type
string
entity_type
string
evidence_hash
string | null
metadata
any
notes
string
ttl_days
integer

Resposta

Verificação de conformidade criada

check_id
string<uuid>
agent_id
string<uuid>
framework
enum<string>
Opções disponíveis:
soc2,
iso27001,
hipaa,
gdpr
scope
object
status
enum<string>
Opções disponíveis:
pending,
passed,
failed,
partial
findings
object[]
created_at
string<date-time>