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

> Obtenha um retrato do stdout e do stderr recentes de uma aplicação com GET /v2/apps/{app_id}/logs. Para logs ao vivo, use o stream SSE em tempo real.

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

  Ao receber um `429`, pare o polling daquela aplicação e aguarde o fim do cooldown 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>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:read`.

Este endpoint busca o buffer mais recente de stdout/stderr da aplicação diretamente do cluster: é um snapshot pontual, não um stream. stdout e stderr são retornados concatenados na ordem em que foram escritos, sem distinção por linha entre os dois, diferente do evento de [Logs em tempo real](/pt-br/api-reference/endpoint/apps/realtime), que prefixa cada linha com o id do seu stream.

Use este endpoint quando precisar de uma consulta pontual da saída recente, por exemplo ao renderizar a aba de logs no carregamento da página ou após um botão de atualização manual. Ele retorna `404` quando a aplicação está offline, nunca recebeu um deploy, ou o cluster retorna um erro transitório. Membros de workspace com acesso à aplicação podem chamá-lo da mesma forma que o proprietário.

## 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 da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `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={"system"}
  {
      "status": "success",
      "response": {
          "logs": "Working!"
      }
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `LOGS_UNAVAILABLE` | 404 | Os logs não puderam ser retornados: a aplicação está offline, nunca recebeu um deploy ou ocorreu um erro transitório. Tente novamente em instantes. |

## Relacionados

* CLI: [`squarecloud app logs`](/pt-br/cli-reference/logs#squarecloud-app-logs)
* SDKs: [`api.apps.logs()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.logs()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.Logs()`](/pt-br/sdks/go/managing_application) (Go)


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