For the complete documentation index, see llms.txt. This page is also available as Markdown.

Autenticação

Guia de autenticação para usar a API da Discloud (como obter e usar com segurança seu Token da API).

Todas as solicitações para a API da Discloud devem incluir um Token da API no cabeçalho api-token.

Se você ainda não tem um token, veja como obter o seu token da API.


⚙️ Como Funciona

1

Você gera um token único vinculado à sua conta.

2

Para cada solicitação HTTP, inclua o cabeçalho: api-token: SEU_TOKEN_AQUI.

3

O token autentica e autoriza ações em nome da sua conta (nunca compartilhe-o).

4

Use o endpoint /user para validar rapidamente o token.


📤 Enviando o Token

curl -X GET \
  -H "api-token: $DISCLOUD_TOKEN" \
  https://api.discloud.app/v2/user
import fetch from "node-fetch";

async function getCurrentUser() {
  const res = await fetch("https://api.discloud.app/v2/user", {
    headers: { "api-token": process.env.DISCLOUD_TOKEN },
  });

  if (!res.ok) {
    console.error("Solicitação falhou:", res.status, await res.text());
    return;
  }
  const data = await res.json();
  console.log(data);
}

getCurrentUser();
// Instale primeiro: npm i discloud.app
const { discloud } = require("discloud.app");

async function validateToken() {
  try {
    const user = await discloud.login(process.env.DISCLOUD_TOKEN);
    console.log("Usuário autenticado:", user);
  } catch (e) {
    console.error("Token inválido ou erro de rede:", e.message);
  }
}

validateToken();

🛡 Protegendo o Token

📌 Melhores práticas:

  • Use variáveis de ambiente em vez de codificar.

  • Rotacione o token periodicamente (ex. a cada 90 dias).

  • Revogue e regenere imediatamente se suspeitar de exposição.

  • Restrinja quem pode acessar a infraestrutura onde a variável está armazenada.


⚡ Verificação Rápida do Token

Chame /user logo após definir a variável de ambiente. Se você receber HTTP 200 com dados do usuário, a autenticação está funcionando.

Você também pode atualizar a localidade do usuário (ex. en-US) através de /locale/{locale} para validar outra rota autenticada.


📚 Referência dos Endpoints Relacionados

As operações abaixo requerem o cabeçalho api-token:

Obter informações do usuário atual

get

Retorna informações sobre o usuário autenticado

Autorizações
api-tokenstringObrigatório
Respostas
200

Operação bem-sucedida

application/json
statusstringOpcional
messagestringOpcional
get/user
GET /v2/user HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
  "status": "ok",
  "message": "Os dados do usuário foram carregados com sucesso",
  "user": {
    "userID": "803658045736878080",
    "totalRamMb": 16384,
    "ramUsedMb": 3386,
    "subdomains": [
      "exemplo"
    ],
    "customdomains": [
      "example.discloud.com"
    ],
    "apps": [
      "1719010867306"
    ],
    "username": "exemplo",
    "avatar": "https://cdn.discordapp.com/embed/avatars/0.png",
    "plan": "Safira",
    "locale": "pt-BR",
    "lastDataLeft": {
      "days": 264,
      "hours": 12,
      "minutes": 6,
      "seconds": 56
    },
    "planDataEnd": "2026-01-12T22:28:58.189Z"
  }
}

Atualizar local do usuário

put

Atualiza o idioma preferido do usuário

Autorizações
api-tokenstringObrigatório
Parâmetros de rota
localestring · enumObrigatório

O idioma a ser definido para o usuário

Valores possíveis:
Respostas
200

Idioma atualizado com sucesso

application/json
statusstringOpcional
messagestringOpcional
localestring · enumOpcionalValores possíveis:
put/locale/{locale}
PUT /v2/locale/{locale} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
  "status": "ok",
  "locale": "en-US"
}

Atualizado