Docs > API Reference

API Reference

A API REST do Certus Engine fornece acesso pragmático aos módulos de governança, auditoria e sanitização PII.

🎭 SANDBOX SIMULADO — sem chamada real de API

Endpoint

Payload (JSON)

Mock Response 🎭200 OK

{
  "status": "success",
  "data": {
    "sanitized_text": "O cliente [NOME_1], CPF [CPF_1] aprovou a proposta.",
    "tokens_generated": 2,
    "latency_ms": 12.4,
    "sec_id": "SEC-PII-001"
  },
  "audit": {
    "lazarus_hash": "a2b4c6d8e0f1234567890abcdef12345",
    "timestamp": "2026-10-18T11:21:45.827Z"
  }
}

Autenticação

Todas as requisições requerem um token de portador (Bearer Token) enviado no header Authorization.

Core Endpoints

POST/v1/pii/sanitize

Inspeciona e mascara PIIs em um payload de texto. Ativa o controle SEC-PII-001.

Request Body (JSON)

{
  "text": "string (required)"
}

POST/v1/inference

Wrapper compatível com a API da OpenAI para roteamento seguro (Fail-Closed ativado: SEC-FC-001).

Request Body (JSON)

{
  "model": "string (required)",
  "messages": [
    { "role": "string", "content": "string" }
  ]
}

GET/v1/evidence/{hash}

Recupera a prova criptográfica LAZARUS (SEC-LAZ-001) associada a uma transação.