Listar dominios de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/domains \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/domains"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/domains"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"hostname": "example.com",
"apex": true,
"companion_of": null,
"redirect_to": null,
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
},
{
"id": "c2a9d4f1-86b0-4a37-b5e8-1f3d7a9c0e62",
"hostname": "www.example.com",
"apex": false,
"companion_of": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_to": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
}
]
}
Dominios
Listar dominios de la aplicación
Lista los dominios personalizados de una aplicación con su estado, el estado del certificado, el puerto, el prefijo de ruta y la redirección.
GET
/
v1
/
apps
/
{id}
/
domains
Listar dominios de la aplicación
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/domains \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/domains"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/domains"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"hostname": "example.com",
"apex": true,
"companion_of": null,
"redirect_to": null,
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
},
{
"id": "c2a9d4f1-86b0-4a37-b5e8-1f3d7a9c0e62",
"hostname": "www.example.com",
"apex": false,
"companion_of": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_to": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
}
]
}
Devuelve todos los dominios personalizados de la aplicación, incluido el complemento automático
www (o el raíz) que
Añadir dominio a la aplicación crea junto al dominio que añades. La lista está vacía si la
aplicación no tiene ninguno. Requiere el scope apps:read cuando se llama con una clave de API.
Para saber cómo funcionan los dominios, consulta la guía de dominios personalizados.
string
requerido
El ID de la aplicación.
string
Si la aplicación pertenece a un workspace, el ID de ese workspace. Obligatorio para los miembros del workspace que actúan sobre una aplicación que no les pertenece.
Respuesta
APIApplicationDomain[]
Los dominios personalizados de la aplicación, del más antiguo al más reciente.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El ID del dominio. Úsalo en las demás rutas de dominios y en
redirect_to.string
El nombre de host, en minúsculas (por ejemplo,
example.com).boolean
true cuando el nombre de host es un dominio raíz (example.com, example.com.br) y no un subdominio.
Un registro CNAME en la raíz solo funciona en los proveedores de DNS que lo aplanan; consulta la guía.string | null
El ID del dominio principal cuando este es su complemento automático
www (o el raíz); null en caso contrario.
Un complemento no cuenta para el límite de dominios del plan.string | null
El ID de otro dominio de la misma aplicación al que redirige este, o
null cuando sirve la aplicación.integer
El estado HTTP de la redirección:
301, 302, 307 o 308. Siempre 308 cuando redirect_to es null.string | null
Una ruta que se antepone a cada petición a la aplicación (por ejemplo,
/api), o null si no hay ninguna.integer
El puerto de la aplicación que sirve este dominio, de
1 a 65535. Por defecto, 80.string
pending (esperando los registros DNS), active (sirviendo la aplicación), moved (el dominio dejó de apuntar a Vertra Cloud)
o deleted (ya no está registrado).string
El estado del certificado HTTPS:
pending, active o failed.string
Cuándo se añadió el dominio.
{
"response": [
{
"id": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"hostname": "example.com",
"apex": true,
"companion_of": null,
"redirect_to": null,
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
},
{
"id": "c2a9d4f1-86b0-4a37-b5e8-1f3d7a9c0e62",
"hostname": "www.example.com",
"apex": false,
"companion_of": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_to": "7b8f5e0a-3c1d-4e52-9a47-0d6e2c1f9b34",
"redirect_status": 308,
"path_prefix": null,
"port": 80,
"status": "active",
"ssl_status": "active",
"created_at": "2026-10-21T14:02:11.000Z"
}
]
}
status y ssl_status se actualizan en segundo plano y cada vez que llamas a Registros DNS del dominio,
así que un dominio puede mostrar pending durante unos minutos después de que sus registros se resuelvan. Un dominio que nunca llega a active
se elimina automáticamente a los 14 días; después, borra sus registros DNS en tu proveedor.Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
VALIDATION_ERROR: El parámetro de ruta o la query no superaron la validación (400). La respuesta incluye tambiénmessageypath.AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas (403).USER_NOT_FOUND: No se pudo resolver el usuario autenticado (401).ACCESS_DENIED: El usuario no tiene permiso para leer la aplicación (403).API_KEY_SCOPE_DENIED: La clave de API no tiene el scopeapps:read(403).APP_NOT_FOUND: La aplicación indicada no existe (404).RATE_LIMIT_EXCEEDED: Se alcanzó el presupuesto de la ruta (429).INTERNAL_SERVER_ERROR: Error inesperado (500).
{
"code": "APP_NOT_FOUND"
}
Esta ruta tiene su propio presupuesto de 30 peticiones por minuto. Consulta Límites de peticiones.
Última modificación el 28 de octubre de 2026