Avaliação técnica

Para quem vai integrar

Especificação viva, gerada a partir do código em produção

Todo comitê de compra tem alguém com poder de veto técnico. Esta página existe para essa pessoa avaliar sem precisar de reunião.

A integração inteira

Duas chamadas, no seu servidor. A primeira pergunta se a pessoa pode realizar a ação. A segunda só é necessária quando a resposta pede mais prova.

A resposta traz a decisão, o motivo, as permissões por finalidade e o identificador do comprovante. Não há biblioteca obrigatória, não há agente para instalar, não há alteração de esquema no seu banco.

Especificação

O contrato completo é publicado em OpenAPI e é gerado a partir dos mesmos tipos que o servidor usa — não é documentação escrita à mão que envelhece em silêncio:

api-pbfqpqcezq-rj.a.run.app/api/v1/openapi.json

Dá para importar direto em Postman, Insomnia ou num gerador de cliente da sua linguagem.

Ambiente de ensaio

Uma chave de teste roteia para fornecedores simulados e permite exercitar onze desfechos — sucesso, recusa, idade desconhecida, demora, limite excedido, erro do fornecedor, resposta corrompida, prova vencida, prova fraca, prova forte e verificação com redirecionamento. Nada disso consome verificação paga.

O objetivo é que o seu time integre e teste todos os caminhos de falha antes de existir contrato.

O que assumimos da sua parte

• chamar do servidor, nunca do navegador — a credencial não pode ficar no cliente;
• enviar um identificador estável do usuário, que convertemos em resumo criptográfico antes de qualquer gravação;
• respeitar a decisão devolvida, inclusive quando ela pede mais prova.

Segurança

• credenciais com escopo, prazo e revogação, guardadas apenas como resumo;
• limite de uso por organização, aplicação, credencial e origem;
• isolamento entre clientes verificado por teste automatizado em leitura, escrita e consulta;
• toda entrega assíncrona de fornecedor é assinada, tem janela de validade e é deduplicada — uma reentrega não produz uma segunda decisão.