Saltar para o conteúdo principal
Uma atestação assina um payload e regista o seu hash. A verificação verifica a integridade criptográfica e o status do registo; não estabelece independentemente que as alegações do emissor são verdadeiras.

Antes de começar

No Console, selecione seu espaço de trabalho e ambiente. Obtenha uma chave de API, ID do emissor e uma chave ativa disponível para assinatura no lado do servidor. Use o algoritmo mostrado para essa chave. Registrar apenas uma chave pública não fornece ao serviço de assinatura sua chave privada. Use https://sandbox-api.truthlocks.com com uma chave sandbox (tl_test_). Use https://api.truthlocks.com com uma chave de produção (tl_live_) e um espaço de trabalho aprovado. Recursos e credenciais devem pertencer ao mesmo ambiente. Não envie X-Tenant-ID para escolher um espaço de trabalho: ele é derivado de suas credenciais.

Cunhar um registro

Este exemplo usa a biblioteca padrão do Python 3. Defina as quatro variáveis de ambiente necessárias através do seu shell ou gerenciador de segredos. Defina TRUTHLOCKS_BASE_URL apenas se estiver mudando do sandbox para a produção.
Erros HTTP levantam urllib.error.HTTPError. Lide com erros e tempos limite em seu aplicativo; preserve a mesma chave de idempotência e corpo ao tentar novamente um resultado de cunhagem incerto. A resposta usa attestation_id, issued_at_unix, signature e log. Ela não ecoa as reivindicações como um payload de nível superior. Mantenha os bytes originais para verificações de integridade subsequentes.

Verificar o resultado

Use a referência de verificação com o attestation_id retornado. Forneça payload_b64url para verificar os bytes originais exatos, ou document_hash_hex para comparar um hash de arquivo. Inspecione verdict e reasons: uma resposta HTTP bem-sucedida por si só não significa que o registro é válido.

Solução de problemas

  • 401 ou 403: verifique credenciais, ambiente, permissões e aprovação do espaço de trabalho.
  • 400: verifique UUIDs, o cabeçalho de idempotência e a codificação base64url sem preenchimento.
  • Erro de chave ou política: confirme se o emissor e a chave podem ser usados para assinatura e se o algoritmo corresponde.
  • Tempo limite: tente novamente com o corpo original e a chave de idempotência, em vez de criar um novo atestado.
Continue com parâmetros de cunhagem, autenticação, e ambientes.