Saltar al contenido principal
POST
Crear verificación de cumplimiento
Ejecuta una evaluación de cumplimiento automatizada para una entidad específica (agente, modelo, conjunto de datos o flujo de trabajo) contra una regulación compatible. La verificación evalúa la configuración de la entidad, los patrones de acceso, el manejo de datos y la pista de auditoría contra los requisitos de la regulación y produce una determinación de cumplimiento con hallazgos detallados. Las verificaciones de cumplimiento son idempotentes para el mismo par entidad-regulación dentro de una ventana de 24 horas. Las llamadas repetidas dentro de esa ventana devuelven el resultado almacenado en caché.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
Identificador único para el registro de verificación de cumplimiento. Formato: maip-cc:ULID.
string
El tipo de entidad que fue evaluada.
string
El identificador de la entidad evaluada.
string
La regulación que fue evaluada.
string
El alcance de la evaluación. full si no se especificó ningún alcance.
string
La determinación de cumplimiento. Una de las siguientes: - compliant — la entidad cumple con todos requisitos evaluados - non_compliant — la entidad falla uno o más requisitos críticos requisitos - partial — la entidad cumple algunos, pero no todos los requisitos
object[]
Lista detallada de hallazgos individuales de la evaluación.
string
El recibo MAIP acuñado para esta verificación de cumplimiento, proporcionando un registro de auditoría.
string
Marca de tiempo ISO 8601 de cuándo se realizó la evaluación.

Regulaciones admitidas

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

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

Respuesta

Verificación de cumplimiento creada

check_id
string<uuid>
agent_id
string<uuid>
framework
enum<string>
Opciones disponibles:
soc2,
iso27001,
hipaa,
gdpr
scope
object
status
enum<string>
Opciones disponibles:
pending,
passed,
failed,
partial
findings
object[]
created_at
string<date-time>