Saltar para o conteúdo principal
Guia Rápido e Estratégia de API para Desenvolvedores

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:
  1. Dados Originais: O payload que você cunhou.
  2. Assinatura do Emissor: Sua prova criptográfica de intenção.
  3. 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.
Use nossos SDKs para lidar com novas tentativas, verificação de assinatura e serialização de payload automaticamente.