> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exemplos de Integração

> Um exemplo de cunhagem HTTP direta com codificação explícita e idempotência.

Este exemplo usa o `fetch` embutido do Node.js para tornar o contrato HTTP explícito. Não depende de uma versão do SDK. As versões do SDK podem ter modelos e opções de autenticação diferentes; verifique a versão instalada antes de adaptar os exemplos.

## Pré-requisitos

Use uma chave de API, emissor e chave de assinatura gerenciada disponível do mesmo ambiente. O registro de chave pública por si só não provisiona uma chave de assinatura privada. Conclua a [configuração do espaço de trabalho](https://docs.truthlocks.com/pt/quickstart.md) primeiro.

## Cunhar com Node.js

Salve como `mint.mjs`. Configure as variáveis de ambiente abaixo através do seu shell ou gerenciador de segredos, então execute `node mint.mjs` com uma versão Node.js que suporte `fetch`.

```javascript theme={null}
import { randomUUID } from 'node:crypto';

const required = name => {
  const value = process.env[name];
  if (!value) throw new Error(`Set ${name}`);
  return value;
};
const baseUrl = (process.env.TRUTHLOCKS_BASE_URL ??
  'https://sandbox-api.truthlocks.com').replace(/\/$/, '');
const payload = Buffer.from(JSON.stringify({
  subject: 'demo-record', message: 'Example issuer claim'
}), 'utf8');
const body = {
  issuer_id: required('TRUTHLOCKS_ISSUER_ID'),
  kid: required('TRUTHLOCKS_KEY_ID'),
  alg: required('TRUTHLOCKS_ALGORITHM'),
  content_type: 'application/json',
  payload_b64url: payload.toString('base64url'),
};
// Persist this value with the body before issuing requests in a durable job.
const idempotencyKey = randomUUID();
const response = await fetch(`${baseUrl}/v1/attestations/mint`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': required('TRUTHLOCKS_API_KEY'),
    'Idempotency-Key': idempotencyKey,
  },
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Mint failed: HTTP ${response.status}`);
const record = await response.json();
console.log({ attestationId: record.attestation_id, recordedAt: record.issued_at_unix });
```

Mantenha o corpo original e a chave de idempotência ao tentar novamente após um tempo limite. Este breve exemplo não implementa trabalhos persistentes ou novas tentativas automáticas. Evite registrar chaves de API, cargas úteis privadas ou respostas brutas contendo dados pessoais.

## Verificar e interpretar resultados

Envie o ID retornado para [Verify](https://docs.truthlocks.com/pt/api-reference/verify.md). Adicione o `payload_b64url` original se quiser verificar os bytes exatos. Inspecione `verdict` e `reasons`; HTTP 200 sozinho não estabelece validade.

A assinatura prova uma relação criptográfica com a chave de assinatura. Ela não verifica independentemente a verdade real das reivindicações enviadas.

Para a versão da biblioteca padrão do Python, consulte o [guia de início rápido](https://docs.truthlocks.com/pt/quickstart.md). Para revogação e substituição, siga os contratos de solicitação gerados para [revogar](https://docs.truthlocks.com/pt/api-reference/attestations/revoke.md) e [substituir](https://docs.truthlocks.com/pt/api-reference/attestations/supersede.md); não reutilize um corpo de cunhagem para essas operações.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.