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

# Consultar informações da aplicação

> Obtenha os metadados de uma aplicação com GET /v2/apps/{app_id}: nome, dono, cluster, RAM alocada, linguagem e domínio. Vale para aplicações de workspace.

<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 retorna a identidade e a configuração de uma aplicação: nome, proprietário, cluster, RAM alocada, linguagem de programação e configuração de DNS. É o endpoint a chamar quando você precisa consultar os metadados de uma aplicação antes de agir sobre ela, por exemplo para confirmar em qual cluster ela está ou em qual subdomínio ela pode ser acessada.

O acesso é restrito a quem faz a chamada: se a aplicação pertence a um workspace do qual você é membro, ela é retornada automaticamente, sem nenhum parâmetro extra. Para uso de recursos em tempo real em vez de metadados estáticos, veja [Obter status da aplicação](/pt-br/api-reference/endpoint/apps/status); para os hostnames configurados em toda a sua conta, veja [Listar domínios](/pt-br/api-reference/endpoint/apps/domains).

## 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="name" type="string">
      O nome da aplicação.
    </ResponseField>

    <ResponseField name="id" type="string">
      O ID da aplicação.
    </ResponseField>

    <ResponseField name="owner" type="string">
      O ID do proprietário da aplicação.
    </ResponseField>

    <ResponseField name="cluster" type="string">
      O cluster da aplicação.
    </ResponseField>

    <ResponseField name="ram" type="number">
      O uso de RAM da aplicação em MB.
    </ResponseField>

    <ResponseField name="language" type="string">
      A linguagem de programação da aplicação.
    </ResponseField>

    <ResponseField name="domain" type="string">
      O domínio da aplicação (null se não aplicável).
    </ResponseField>

    <ResponseField name="custom" type="string">
      Informações customizadas sobre a aplicação (null se não aplicável).
    </ResponseField>

    <ResponseField name="created_at" type="date">
      A data de criação da aplicação.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={"system"}
  {
    "status": "success",
    "response": {
      "name": "Best bot forever",
      "id": "64d0c750212742ca8704fb458c9771af",
      "owner": "3133971456989594464",
      "cluster": "nasa-cluster",
      "ram": 1024,
      "language": "rust",
      "domain": null,
      "custom": null,
      "created_at": "2023-02-20T14:30:00Z"
    }
  }
  ```
</ResponseExample>

## Relacionados

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


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