1. Autenticação
Todas as solicitações de API devem ser autenticadas via tokens Bearer.- Chaves de API: Emitidas via Console do Locatário (Segurança > Chaves de API).
- Escopos: As chaves são escopadas para ações específicas (por exemplo,
mint,verify,read_audit). - Rotação: Recomendamos uma política de rotação de 90 dias. Invalide as chaves imediatamente via endpoint DELETE em caso de comprometimento.
2. O Fluxo de Cunhagem
Para emitir uma atestação, POST um payload JSON para/v1/attestations/mint.
3. Webhooks e Eventos
Truthlocks usa webhooks para notificar seu sistema sobre mudanças de estado.
Verificação: Sempre verifique o cabeçalho
X-Truthlocks-Signature usando o segredo compartilhado do seu endpoint. Consulte o guia de webhooks para detalhes completos sobre tipos de eventos, verificação de assinatura e comportamento de repetição.
4. Pacotes de Prova
Um Pacote de Prova é um objeto JSON assinado contendo:- Dados Originais: O payload que você cunhou.
- Assinatura do Emissor: Sua prova criptográfica de intenção.
- Ponto de Verificação da Plataforma: Prova de Truthlocks do estado da rede no momento da cunhagem.
5. Limites de Taxa e Cotas
Os limites são aplicados por locatário com base no seu nível de assinatura:- Rajada Global: 500 requisições a cada 10 segundos.
- Cota Mensal de Cunhagem: Definida no seu Contrato Empresarial (visível em
/v1/billing/usage).
6. Separação de Ambiente
Oferecemos dois ambientes distintos:- Sandbox (
sandbox.truthlocks.com): Para testes com chaves simuladas e dados efêmeros. - Produção (
api.truthlocks.com): Federado para emissão de alto risco.

