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"
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);
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"]))
{
"status": "success",
"code": "SUCCESS",
"response": {
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"plan": {
"name": "Bronze",
"memory": {
"limit": 2048,
"available": 1792,
"used": 256
},
"duration": 1795142400000
}
},
"applications": []
},
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"plan": {
"name": "Bronze",
"memory": {
"limit": 2048,
"available": 1792,
"used": 256
},
"duration": 1795142400000
}
},
"applications": [],
"success": true
}
Conta
Consultar a conta
Retorna o perfil autenticado, a memória do plano e as aplicações acessíveis.
GET
/
v3
/
users
/
me
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"
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);
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"]))
{
"status": "success",
"code": "SUCCESS",
"response": {
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"plan": {
"name": "Bronze",
"memory": {
"limit": 2048,
"available": 1792,
"used": 256
},
"duration": 1795142400000
}
},
"applications": []
},
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"plan": {
"name": "Bronze",
"memory": {
"limit": 2048,
"available": 1792,
"used": 256
},
"duration": 1795142400000
}
},
"applications": [],
"success": true
}
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.
{
"status": "success",
"code": "SUCCESS",
"response": {
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"plan": {
"name": "Bronze",
"memory": {
"limit": 2048,
"available": 1792,
"used": 256
},
"duration": 1795142400000
}
},
"applications": []
},
"user": {
"id": "42",
"name": "dev-exemplo",
"email": "[email protected]",
"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. |
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"
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);
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"]))