> ## 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.

# Pacote de Integração Técnica

> Guia de Início Rápido e Estratégia de API para Desenvolvedores

**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`.

```json theme={null}
{
  "template_key": "academic_transcript",
  "payload": {
    "student_id": "STU123",
    "gpa": "3.8"
  },
  "recipient_email": "student@university.edu"
}
```

## 3. Webhooks e Eventos

Truthlocks usa webhooks para notificar seu sistema sobre mudanças de estado.

| Tipo de Evento | Descrição |
| :- | :- |
| `attestation.created` | Acionado quando a plataforma assinou o registro. |
| `issuer.suspended` | Acionado se a classificação de confiança do emissor mudar. |
| `billing.usage.threshold` | Acionado quando um limite de uso é atingido. |

**Verificação**: Sempre verifique o cabeçalho `X-Truthlocks-Signature` usando o segredo compartilhado do seu endpoint. Consulte o [guia de webhooks](https://docs.truthlocks.com/pt/guides/webhooks.md) 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.

> [!TIP]
>
> Use nossos [SDKs](https://docs.truthlocks.com/pt/sdk/js.md) para lidar com novas tentativas, verificação de assinatura e
> serialização de payload automaticamente.


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