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

# Uso

> Acompanhe o uso da API da Enrow e o consumo de créditos, e otimize as requisições com endpoints em lote, webhooks e cache

Esta página explica como monitorar o uso da API da Enrow e o consumo de créditos, e como otimizar suas requisições para gastar menos créditos. Para entender como os créditos são precificados por endpoint, consulte [Créditos e cobrança](/pt/credits-billing).

## Como acompanho o uso da minha API?

Você pode acompanhar o uso da API da Enrow de duas maneiras: visualmente no dashboard ou de forma programática por meio do endpoint da conta.

### Onde posso ver o uso no dashboard?

O [Dashboard da Enrow](https://app.enrow.io) oferece uma visão em tempo real do seu uso:

* Créditos consumidos ao longo do tempo
* Detalhamento por endpoint
* Taxas de sucesso e de falha
* Créditos restantes

### Como verifico o uso com a API?

Consulte o endpoint da conta para verificar o uso de forma programática. Autentique a requisição com sua [chave de API](/pt/authentication) no cabeçalho `x-api-key` — nenhum payload no corpo é necessário:

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Response theme={null}
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
```

O valor de `credits` é o seu saldo restante, e `webhooks` lista as URLs registradas na sua conta. Consulte a referência [Informações da conta](/pt/api-reference/account/info) para o esquema completo da resposta.

## Como otimizo o uso da minha API?

Para reduzir o consumo de créditos e permanecer dentro dos seus [limites de taxa](/pt/rate-limits), agrupe suas requisições com endpoints em lote, receba resultados com webhooks em vez de polling e armazene em cache os resultados que você já recuperou.

<AccordionGroup>
  <Accordion title="Usar endpoints em lote">
    Em vez de fazer muitas requisições individuais, agrupe-as (até 5.000 entradas por requisição de e-mail em lote, 3.000 por requisição de telefone em lote):

    ```javascript theme={null}
    // ❌ 100 separate requests
    for (const contact of contacts) {
      await findEmail(contact);
    }

    // ✅ 1 bulk request
    await findEmailsBulk(contacts);
    ```

    Consulte [Encontrar e-mails](/pt/api-reference/email-finder/find-bulk) e [Encontrar telefones](/pt/api-reference/phone/find-bulk) para operações em lote.
  </Accordion>

  <Accordion title="Usar webhooks em vez de polling">
    O polling desperdiça créditos e cota de limite de taxa. Use webhooks para receber os resultados automaticamente:

    ```json theme={null}
    {
      "fullname": "John Doe",
      "company_domain": "example.com",
      "settings": {
        "webhook": "https://your-app.com/webhook"
      }
    }
    ```

    Saiba como funciona a entrega em [Como os webhooks funcionam](/pt/how-webhooks-work).
  </Accordion>

  <Accordion title="Armazenar resultados em cache">
    Armazene os resultados para evitar chamadas de API redundantes para o mesmo contato.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="O endpoint de uso custa créditos?">
    Não. Consultar o endpoint [Informações da conta](/pt/api-reference/account/info) retorna seus créditos restantes e webhooks registrados sem consumir nenhum crédito.
  </Accordion>

  <Accordion title="Buscas que falham consomem créditos?">
    Os créditos são consumidos conforme as regras em [Créditos e cobrança](/pt/credits-billing). Quando uma requisição falha antes do processamento — por exemplo, uma resposta `402 Insufficient credits` — nenhum crédito é debitado. Consulte [Tratamento de erros](/pt/error-handling) e [Códigos de status](/pt/status-codes) para os formatos de resposta.
  </Accordion>

  <Accordion title="Como posso evitar atingir os limites de taxa?">
    Agrupe suas requisições com endpoints em lote e use webhooks em vez de polling para obter os resultados. Ambos reduzem o número de chamadas que você faz. Consulte [Limites de taxa](/pt/rate-limits) para os limites atuais de requisições.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Créditos e cobrança" icon="coins" href="/pt/credits-billing">
    Veja como os créditos são consumidos em cada endpoint.
  </Card>

  <Card title="Informações da conta" icon="circle-user" href="/pt/api-reference/account/info">
    Recupere seu saldo de créditos e webhooks registrados.
  </Card>

  <Card title="Webhooks" icon="bell" href="/pt/how-webhooks-work">
    Receba os resultados automaticamente em vez de fazer polling.
  </Card>

  <Card title="Limites de taxa" icon="gauge-high" href="/pt/rate-limits">
    Entenda os limites de requisições da API antes de escalar.
  </Card>
</CardGroup>