> ## 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 status do serviço

> Verifique a saúde geral da plataforma Square Cloud com GET /v2/service/status. É público, não exige chave de API e é servido de um cache de 5 minutos.

Status do Serviço retorna a saúde agregada da plataforma Square Cloud, o mesmo sinal que alimenta a página pública de status e os alertas internos. É uma rota pública, sem necessidade de chave de API, o que a torna adequada para verificações automatizadas de disponibilidade ou um pequeno widget de status no seu próprio site.

O payload é servido a partir de um cache de 5 minutos, então ele pode ficar atrás de um incidente transitório em até essa janela e não deve ser tratado como um feed de incidentes em tempo real. Se o valor em cache não puder ser lido, o endpoint ainda responde com sucesso, retornando `status: "unknown"` em vez de falhar a requisição.

Para a saúde de uma aplicação específica em vez de toda a plataforma, veja [Obter Status da Aplicação](/pt-br/api-reference/endpoint/apps/status) ou [Obter Status de Todas as Aplicações](/pt-br/api-reference/endpoint/apps/status-all).

<Info>
  Esta rota possui cache de 5 minutos e não reflete o status em tempo real de
  status.squarecloud.app.
</Info>

## Resposta

<ResponseField name="status" type="string">
  O status atual da Square Cloud, com `online` indicando que o serviço está online, `degraded` indicando problemas e `unknown` indicando indisponibilidade.
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem sobre o status atual dos serviços da Square Cloud.
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "online",
      "message": "Todos os serviços estão online."
  }
  ```
</ResponseExample>

## Relacionados

* CLI: [`squarecloud status`](/pt-br/cli-reference/global-flags-and-ci#squarecloud-status)
* SDKs: [`api.service.status()`](/pt-br/sdks/js/client) (JavaScript), [`client.service.status()`](/pt-br/sdks/py/client) (Python), [`c.Service.Status()`](/pt-br/sdks/go/client) (Go)


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