# Documentação da API



## Ferramentas

<ToolCards />

## Primeiros passos

<Steps>
  <Step>
    ### Crie um token de API

    No [dashboard](https://dashboard.respawntech.dev), abra **APIs** e crie um token com os escopos da ferramenta que vai usar. Guarde-o na variável de ambiente `RESPAWN_API_TOKEN`. Veja [Autenticação](/autenticacao).
  </Step>

  <Step>
    ### Estime o custo com dry-run

    Envie `X-Dry-Run: true` antes de uma operação paga para validar o payload e ver o custo sem debitar créditos. Veja [Cobrança e limites](/cobranca-e-limites#dry-run).
  </Step>

  <Step>
    ### Faça a chamada

    Todas as rotas de ferramentas usam o prefixo `https://api.respawntech.dev/v1/tools`. Cada endpoint traz exemplos prontos em cURL, JavaScript e Python.

    <ApiExamples method="GET" path="/v1/tools/image/qr-code/dynamic" query={{ limit: '20' }} />
  </Step>
</Steps>

## Headers comuns

| Header              | Valor          | Efeito                                                                 |
| ------------------- | -------------- | ---------------------------------------------------------------------- |
| `X-API-Token`       | `rsk_live_...` | Autenticação (recomendado)                                             |
| `X-Dry-Run`         | `true`         | Simula a operação sem persistir nem debitar                            |
| `X-Include-Cost`    | `true`         | Inclui `meta.cost` na resposta                                         |
| `X-Idempotency-Key` | UUID           | Evita cobrança duplicada em reenvios (<Limit name="idempotencyTtl" />) |

Respostas trazem `X-Trace-Id` (use em tickets de suporte), `X-RateLimit-*` e, em leituras medidas, `X-API-Quota-*`.

## Guias

<Cards>
  <Card title="Autenticação" description="Token de API, escopos e requisitos da conta." href="/autenticacao" />

  <Card title="Cobrança e limites" description="Créditos, dry-run, idempotência, rate limit e franquia diária." href="/cobranca-e-limites" />

  <Card title="Webhooks" description="Eventos da conta, assinatura Standard Webhooks, retries e callbacks de jobs." href="/webhooks" />

  <Card title="Códigos de erro" description="Envelope de resposta e todos os códigos por ferramenta." href="/erros" />

  <Card title="Agentes de IA (MCP)" description="Conecte Claude, Cursor e outros agentes às ferramentas, com limite de gasto." href="/agentes-de-ia" />
</Cards>