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

# Autenticação e chaves

> Envie a chave da conta no cabeçalho Authorization e mantenha-a fora do código.

Entre na sua conta para obter a chave de API. Abra o [painel da DSCloud](https://dscloud.pt/dashboard). Se a opção **API Key** não estiver disponível na interface da sua conta, solicite orientação pelo [suporte](https://docs.dscloud.pt/corporation/support.md). Consulte a [disponibilidade da API](https://docs.dscloud.pt/api-reference/introduction.md) antes de enviar a chave.

## Envie a chave no cabeçalho Authorization

Nos exemplos, `DSCLOUD_API_KEY` é uma variável de ambiente com a chave da conta. O servidor aceita a chave no cabeçalho `Authorization`, com ou sem o prefixo `Bearer `. Os exemplos usam a chave diretamente.

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

> [!WARNING]
>
> Guarde a chave em um gerenciador de segredos e injete-a no processo. Evite incluí-la no frontend, em logs, no ZIP ou no histórico Git. Em caso de exposição, solicite a substituição da credencial e atualize as integrações afetadas.

Uma requisição sem o cabeçalho recebe `401 UNAUTHORIZED`. Confira o host, o valor do cabeçalho e o recurso solicitado. Consulte [erros e limites](https://docs.dscloud.pt/api-reference/restrictions.md).


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