Matriz 54 Integration Gateway

API Gateway de alta performance e desacoplado para orquestração de assinaturas digitais (Clicksign v3.0), filas serverless (Upstash Redis) e webhooks para o ecossistema Matriz 54.

🚀 Documentação Interativa (Scalar UI) ⚡ Health Check API

📌 Endpoints Principais

⚡

Disparo de Assinatura

Rota única assíncrona com controle de idempotência em Redis e enfileiramento imediato na Clicksign v3.

POST /api/v1/signatures/dispatch

🔄

Processador da Fila

Consumidor serverless para processar em lote os jobs pendentes da fila do Upstash Redis (Vercel Cron / Trigger).

POST /api/v1/signatures/process-queue

🛡️

Segurança & Autenticação

Todas as rotas são protegidas via validação de chave no cabeçalho HTTP X-API-KEY.

HEADER X-API-KEY: <SECRET>

💻 Exemplo de Requisição (cURL)

curl -X POST http://localhost:3333/api/v1/signatures/dispatch \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: matriz54_super_secret_integration_key" \
  -d '{
    "tenant_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
    "idempotency_key": "req-001",
    "document": { "name": "Contrato.pdf", "url": "https://.../documento.pdf" },
    "signers": [{ "name": "João", "email": "joao@exemplo.com", "cpf": "11144477735" }]
  }'