curl -X GET 'https://api.sondercloud.app/v1/databases/{id}' \
-H 'Authorization: Bearer seu_token'
{
"id": "{id}",
"name": "meu-banco",
"engine": "postgresql",
"status": "RUNNING",
"memoryMb": 256,
"containerName": "sonder-{id}",
"host": "db-01.sondercloud.app",
"port": 5432,
"internalHost": "sonder-{id}",
"internalPort": 5432,
"database": "meu_banco",
"username": "sonder_user",
"password": "senha_gerada",
"connectionString": "postgresql://sonder_user:senha_gerada@db-01.sondercloud.app:5432/meu_banco",
"internalConnectionString": "postgresql://sonder_user:senha_gerada@sonder-{id}:5432/meu_banco",
"accessNote": "Use o host interno para conexões entre apps na mesma rede SonderCloud",
"createdAt": "2026-07-01T10:00:00Z"
}
Gerenciamento
Detalhes da Database
Retorna informações completas de uma database, incluindo credenciais de conexão
GET
/
v1
/
databases
/
{id}
curl -X GET 'https://api.sondercloud.app/v1/databases/{id}' \
-H 'Authorization: Bearer seu_token'
{
"id": "{id}",
"name": "meu-banco",
"engine": "postgresql",
"status": "RUNNING",
"memoryMb": 256,
"containerName": "sonder-{id}",
"host": "db-01.sondercloud.app",
"port": 5432,
"internalHost": "sonder-{id}",
"internalPort": 5432,
"database": "meu_banco",
"username": "sonder_user",
"password": "senha_gerada",
"connectionString": "postgresql://sonder_user:senha_gerada@db-01.sondercloud.app:5432/meu_banco",
"internalConnectionString": "postgresql://sonder_user:senha_gerada@sonder-{id}:5432/meu_banco",
"accessNote": "Use o host interno para conexões entre apps na mesma rede SonderCloud",
"createdAt": "2026-07-01T10:00:00Z"
}
curl -X GET 'https://api.sondercloud.app/v1/databases/{id}' \
-H 'Authorization: Bearer seu_token'
{
"id": "{id}",
"name": "meu-banco",
"engine": "postgresql",
"status": "RUNNING",
"memoryMb": 256,
"containerName": "sonder-{id}",
"host": "db-01.sondercloud.app",
"port": 5432,
"internalHost": "sonder-{id}",
"internalPort": 5432,
"database": "meu_banco",
"username": "sonder_user",
"password": "senha_gerada",
"connectionString": "postgresql://sonder_user:senha_gerada@db-01.sondercloud.app:5432/meu_banco",
"internalConnectionString": "postgresql://sonder_user:senha_gerada@sonder-{id}:5432/meu_banco",
"accessNote": "Use o host interno para conexões entre apps na mesma rede SonderCloud",
"createdAt": "2026-07-01T10:00:00Z"
}
Campos da Resposta
string
Host externo, usado para conexões de fora da rede SonderCloud.
string
Hostname interno, usado para conexões entre apps e databases dentro da rede Docker da SonderCloud. Mais rápido e não conta como tráfego externo.
Authorizations
Token de API da SonderCloud, enviado no header Authorization: Bearer <token>
Path Parameters
ID da database
Response
Detalhes da database
Available options:
postgresql, mysql, mongodb, redis Hostname interno via rede Docker