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

# Consultar a conta

> Retorna o perfil autenticado, a memória do plano e as aplicações acessíveis.

Use `response.applications[].id` nas rotas de aplicações.

## Resposta

HTTP 200. `response` é um objeto. Seus campos também podem aparecer no nível superior por compatibilidade.

```json HTTP 200 theme={null}
{
  "status": "success",
  "code": "SUCCESS",
  "response": {
    "user": {
      "id": "42",
      "name": "dev-exemplo",
      "email": "dev@example.com",
      "plan": {
        "name": "Bronze",
        "memory": {
          "limit": 2048,
          "available": 1792,
          "used": 256
        },
        "duration": 1795142400000
      }
    },
    "applications": []
  },
  "user": {
    "id": "42",
    "name": "dev-exemplo",
    "email": "dev@example.com",
    "plan": {
      "name": "Bronze",
      "memory": {
        "limit": 2048,
        "available": 1792,
        "used": 256
      },
      "duration": 1795142400000
    }
  },
  "applications": [],
  "success": true
}
```

| Campo em `response` | Descrição |
| - | - |
| `user.id` | ID da conta. |
| `user.plan.memory` | Memória do plano em MB, com limite, saldo disponível e uso atual. |
| `user.plan.duration` | Data de expiração do plano em milissegundos desde a época Unix. |
| `applications` | Aplicações acessíveis, com identificadores, nomes e metadados. |

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 404 | `USER_NOT_FOUND` | O perfil da conta não foi encontrado. |

```bash cURL theme={null}
base="${DSCLOUD_API_BASE_URL:-https://api.dscloud.pt/v3}"
: "${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}"
curl --proto '=https' --fail-with-body \
  --header "Authorization: $DSCLOUD_API_KEY" \
  "${base%/}/users/me"
```

```javascript JavaScript (Node.js 18+) theme={null}
const base = (process.env.DSCLOUD_API_BASE_URL ??
  "https://api.dscloud.pt/v3").replace(/\/$/, "");
if (new URL(base).protocol !== "https:") {
  throw new Error("Use um endereço HTTPS para a API");
}
const key = process.env.DSCLOUD_API_KEY;
if (!key) throw new Error("Defina DSCLOUD_API_KEY");

const response = await fetch(`${base}/users/me`, {
  headers: { Authorization: key },
  signal: AbortSignal.timeout(10_000),
});
if (!response.ok) throw new Error(`DSCloud HTTP ${response.status}`);
const { response: { user, applications } } = await response.json();
console.log(user.name, applications.length);
```

```python Python theme={null}
import json
import os
from urllib.parse import urlsplit
from urllib.request import Request, urlopen

base = os.getenv("DSCLOUD_API_BASE_URL", "https://api.dscloud.pt/v3")
if urlsplit(base).scheme != "https":
    raise ValueError("Use um endereço HTTPS para a API")
key = os.environ["DSCLOUD_API_KEY"]
request = Request(
    f"{base.rstrip('/')}/users/me",
    headers={"Authorization": key},
)
with urlopen(request, timeout=10) as result:
    account = json.load(result)["response"]
print(account["user"]["name"], len(account["applications"]))
```


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