🔌 Integracoes e APIs

# Estrutura padrao de endpoints GIPM
POST /api/v1/generate          # Gerar conteudo
POST /api/v1/analyze           # Analisar dados
POST /api/v1/transform         # Transformar formato

# Todos retornam estrutura consistente
{
    "execution_id": "uuid",
    "status": "success|error",
    "data": { ... },
    "metadata": {
        "cost_usd": 0.003,
        "tokens_used": 150,
        "duration_ms": 1200
    }
}

# Configuracao de webhook
webhook_config = {
    "url": "https://client.com/webhook",
    "events": ["generation.completed", "error.occurred"],
    "secret": "hmac_secret_for_verification",
    "retry_policy": {
        "max_attempts": 3,
        "backoff": "exponential"
    }
}

# Payload enviado
{
    "event": "generation.completed",
    "timestamp": "2026-01-16T10:30:00Z",
    "data": { "execution_id": "...", "artifact_url": "..." },
    "signature": "sha256=..."
}

Funcoes do API Gateway

# JWT com claims GIPM
jwt_payload = {
    "sub": "user_id",
    "tenant_id": "tenant_123",
    "permissions": ["generate:read", "generate:write"],
    "cost_limit_usd": 100.00,
    "allowed_personas": ["analyst", "reviewer"],
    "exp": 1705400000
}

# Middleware de validacao
async def validate_request(token: str, request: Request):
    claims = verify_jwt(token)
    if request.cost_estimate > claims["cost_limit_usd"]:
        raise CostLimitExceeded()
    if request.persona not in claims["allowed_personas"]:
        raise PersonaNotAllowed()

Estrategias de limitacao