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

# Obter logs

> Coletar as últimas 1000 linhas de logs da sua aplicação. Possui limite de taxa de 1 requisição a cada 5 segundos.

<Warning>
  Este endpoint tem limite de taxa rígido. Exceder **qualquer** um dos limites retorna `429 Too Many Requests`:

  * **1 requisição a cada 5 segundos** por usuário e por aplicação.
  * **20 requisições a cada 10 segundos** por usuário, somando todas as aplicações, seguidas de um **cooldown de 30 segundos**.

  Ao receber um `429`, pare o polling daquela aplicação e aguarde pelo menos o cooldown (\~30 segundos) antes de tentar novamente.
</Warning>

<Tip>
  Use este endpoint apenas para um **snapshot pontual** dos logs (ao abrir a aba de logs ou em um refresh manual). Para **logs ao vivo e contínuos**, use o endpoint [Logs em tempo real](/pt-br/api-reference/endpoint/apps/realtime) (SSE), que transmite os logs em tempo real sem atingir este limite de taxa.
</Tip>

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

### Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.
</ParamField>

### Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="logs" type="string">
      Os logs mais recentes da aplicação.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "status": "success",
      "response": {
          "logs": "Working!"
      }
  }
  ```
</ResponseExample>