> For the complete documentation index, see [llms.txt](https://docs.discloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discloud.com/api-and-sdks/api-overview/user.md).

# Usuário

Consulte as informações da sua conta Discloud pela API.

## Obter informações do usuário atual

> Retorna informações sobre o usuário autenticado

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Usuário","description":"Operações sobre usuários"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"UserResponse":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"user":{"$ref":"#/components/schemas/User"}}},"User":{"type":"object","properties":{"userID":{"type":"string","description":"O ID do usuário"},"username":{"type":"string","nullable":true,"description":"O nome de usuário"},"avatar":{"type":"string","nullable":true,"description":"URL do avatar do usuário"},"totalRamMb":{"type":"integer","description":"RAM total alocada (em MB)"},"ramUsedMb":{"type":"integer","description":"RAM atualmente sendo usada (em MB)"},"subdomains":{"type":"array","items":{"type":"string"},"description":"Lista de subdomínios pertencentes"},"customdomains":{"type":"array","items":{"type":"string"},"description":"Lista de domínios personalizados pertencentes"},"apps":{"type":"array","items":{"type":"string"},"description":"Lista de IDs das aplicações pertencentes"},"plan":{"type":"string","description":"O plano de assinatura"},"locale":{"type":"string","description":"O idioma/localização"},"lastDataLeft":{"type":"object","properties":{"days":{"type":"integer","description":"Dias restantes no plano atual"},"hours":{"type":"integer","description":"Horas restantes no plano atual"},"minutes":{"type":"integer","description":"Minutos restantes no plano atual"},"seconds":{"type":"integer","description":"Segundos restantes no plano atual"}},"description":"Tempo restante do plano atual"},"planDataEnd":{"type":"string","description":"Data de término do plano atual, ou \"Subscription\" para planos por assinatura"}}},"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/user":{"get":{"tags":["Usuário"],"summary":"Obter informações do usuário atual","description":"Retorna informações sobre o usuário autenticado","operationId":"getCurrentUser","responses":{"200":{"description":"Operação bem-sucedida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponse"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Atualizar local do usuário

> Atualiza o idioma preferido do usuário

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Usuário","description":"Operações sobre usuários"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"LocaleResponse":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"locale":{"type":"string","enum":["pt-BR","en-US"]}}},"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}},"LocaleErrorResponse":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"localeList":{"type":"array","items":{"type":"string"}}}}}},"paths":{"/locale/{locale}":{"put":{"tags":["Usuário"],"summary":"Atualizar local do usuário","description":"Atualiza o idioma preferido do usuário","operationId":"updateUserLocale","parameters":[{"name":"locale","in":"path","required":true,"description":"O idioma a ser definido para o usuário","schema":{"type":"string","enum":["pt-BR","en-US"]}}],"responses":{"200":{"description":"Idioma atualizado com sucesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocaleResponse"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Idioma especificado inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocaleErrorResponse"}}}}}}}}}
```

## Obter dados do usuário para a extensão VS Code

> Retorna os dados do usuário autenticado junto com os dados das suas aplicações (appsStatus) e os IDs das aplicações em que é moderador (appsTeam). Rota usada pela extensão Discloud para VS Code.

```json
{"openapi":"3.0.3","info":{"title":"Discloud API","version":"2.0.0"},"tags":[{"name":"Usuário","description":"Operações sobre usuários"}],"servers":[{"url":"https://api.discloud.app/v2","description":"Servidor API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-token"}},"schemas":{"VscodeUserResponse":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string"},"user":{"type":"object","properties":{"userID":{"type":"string","description":"O ID do usuário"},"username":{"type":"string","nullable":true,"description":"O nome de usuário"},"avatar":{"type":"string","nullable":true,"description":"URL do avatar do usuário"},"plan":{"type":"string","description":"O plano de assinatura"},"locale":{"type":"string","description":"O idioma/localização"},"totalRamMb":{"type":"integer","description":"RAM total alocada (em MB)"},"ramUsedMb":{"type":"integer","description":"RAM atualmente sendo usada (em MB)"},"apps":{"type":"array","items":{"type":"string"},"description":"Lista de IDs das aplicações pertencentes"},"appsTeam":{"type":"array","items":{"type":"string"},"description":"Lista de IDs das aplicações em que o usuário é moderador"},"subdomains":{"type":"array","items":{"type":"string"},"description":"Lista de subdomínios pertencentes"},"customdomains":{"type":"array","items":{"type":"string"},"description":"Lista de domínios personalizados pertencentes"},"appsStatus":{"type":"array","description":"Dados de cada aplicação do usuário","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"integer","description":"Tipo de aplicação (0 = bot, 1 = site)"},"online":{"type":"boolean"},"ram":{"type":"integer"},"ramKilled":{"type":"boolean"},"exitCode":{"type":"integer"},"lang":{"type":"string"},"mainFile":{"type":"string"},"avatarURL":{"type":"string"},"autoRestart":{"type":"boolean"},"apts":{"type":"array","items":{"type":"string"}},"clusterName":{"type":"string"},"version":{"type":"string"}}}}}}}},"Error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"paths":{"/vscode":{"get":{"tags":["Usuário"],"summary":"Obter dados do usuário para a extensão VS Code","description":"Retorna os dados do usuário autenticado junto com os dados das suas aplicações (appsStatus) e os IDs das aplicações em que é moderador (appsTeam). Rota usada pela extensão Discloud para VS Code.","operationId":"getVscodeUser","responses":{"200":{"description":"Operação bem-sucedida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VscodeUserResponse"}}}},"401":{"description":"Erro de autenticação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```
