Ver a conexão

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/connection \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/connection`, { headers });
const { connection } = await res.json();
console.log(connection.host, connection.port); // guarde a senha como segredo

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/connection", headers=headers, timeout=30
)
r.raise_for_status()
c = r.json()["connection"]
print(c["host"], c["port"])

{
  "connection": {
    "host": "cube-t9d1h3xa",
    "port": 2333,
    "password": "Xk3v9QmZ-2bLr7_hP4sN8wTyC1dFgJ6a"
  }
}

GET

projects

{id}

connection

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/connection \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/connection`, { headers });
const { connection } = await res.json();
console.log(connection.host, connection.port); // guarde a senha como segredo

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/connection", headers=headers, timeout=30
)
r.raise_for_status()
c = r.json()["connection"]
print(c["host"], c["port"])

{
  "connection": {
    "host": "cube-t9d1h3xa",
    "port": 2333,
    "password": "Xk3v9QmZ-2bLr7_hP4sN8wTyC1dFgJ6a"
  }
}

Para o projeto de um template com conexão, hoje o Lavalink: devolve o nome interno do projeto (o mesmo internalHost de Ver um projeto), a porta e a senha que a Cube gerou na variável LAVALINK_SERVER_PASSWORD. Com a variável apagada, password vem null. Esses dados só funcionam de dentro da sua conta: ponha a senha numa variável de ambiente do seu bot, nunca no código.

Como a conexão de um banco, esta rota pede uma chave de leitura e escrita, responde sem cache e cada leitura aparece na Atividade, sem a senha.

Erros comuns

Código	HTTP	O que fazer
`insufficient_permission`	403	Use uma chave de leitura e escrita.
`not_found`	404	Confira o ID. O projeto precisa ser de um template com conexão (o Lavalink); trocado por outro `.zip`, ele deixa de ser.

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de caminho

string

obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Resposta

A conexão. Resposta com Cache-Control: no-store.

connection

object

obrigatório

Show child attributes

Visão geral

Projetos

Templates

Controle

Logs e métricas

Análise

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns