Autenticação
Guia de autenticação para usar a API da Discloud (como obter e usar com segurança seu Token da API).
⚙️ Como Funciona
Você gera um token único vinculado à sua conta.
Para cada solicitação HTTP, inclua o cabeçalho: api-token: SEU_TOKEN_AQUI.
O token autentica e autoriza ações em nome da sua conta (nunca compartilhe-o).
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/userimport 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);
}// Instale primeiro: npm i discloud.app
const { discloud } = require("discloud.app");
discloud.login("DISCLOUD_API_TOKEN");
async function validateToken() {
try {
const user = await discloud.user.fetch();
console.log("Usuário autenticado:", user);
} catch (e) {
console.error("Token inválido ou erro de rede:", e.message);
}
}🛡 Protegendo o Token
Nunca commite seu token (ex. no Git). Armazene-o em variáveis de ambiente (.env, segredos CI/CD, etc.).
📌 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.
📚 Referência dos Endpoints Relacionados
As operações abaixo requerem o cabeçalho api-token:
Last updated