Registros DNS del dominio
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/domains/{domain_id}/dns \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/domains/{domain_id}/dns', 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/{domain_id}/dns"
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/{domain_id}/dns"
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": [
{
"type": "CNAME",
"name": "example.com",
"value": "cname.vertraweb.app",
"status": "pending"
},
{
"type": "TXT",
"name": "_acme-challenge.example.com",
"value": "v111d4af8cd74272a284831fbae14a8v",
"status": "pending"
}
]
}
Dominios
Registros DNS del dominio
Devuelve los registros DNS que debes crear en tu proveedor de DNS para que un dominio personalizado se valide y obtenga su certificado HTTPS.
GET
/
v1
/
apps
/
{id}
/
domains
/
{domain_id}
/
dns
Registros DNS del dominio
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/domains/{domain_id}/dns \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/domains/{domain_id}/dns', 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/{domain_id}/dns"
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/{domain_id}/dns"
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": [
{
"type": "CNAME",
"name": "example.com",
"value": "cname.vertraweb.app",
"status": "pending"
},
{
"type": "TXT",
"name": "_acme-challenge.example.com",
"value": "v111d4af8cd74272a284831fbae14a8v",
"status": "pending"
}
]
}
Devuelve los registros que creas en el proveedor de DNS del dominio: un
CNAME que apunta el nombre de host a Vertra Cloud, más los registros
que validan la propiedad y emiten el certificado HTTPS. Cada registro tiene su propio status, así que puedes ver cuáles ya se resuelven.
Llamar a esta ruta también actualiza el status y el ssl_status del dominio. Requiere el scope apps:read cuando se llama con una clave de API.
string
requerido
El ID de la aplicación.
string
requerido
El ID del dominio, obtenido de Listar dominios 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
APIApplicationDomainDnsRecord[]
Los registros que hay que crear.
{
"response": [
{
"type": "CNAME",
"name": "example.com",
"value": "cname.vertraweb.app",
"status": "pending"
},
{
"type": "TXT",
"name": "_acme-challenge.example.com",
"value": "v111d4af8cd74272a284831fbae14a8v",
"status": "pending"
}
]
}
Crea cada registro exactamente como se devuelve, y elimina antes cualquier otro registro
A, AAAA o CNAME con el mismo nombre. Un dominio raíz
(apex: true) necesita un proveedor de DNS que admita CNAME en la raíz. Consulta la guía de dominios personalizados.
Cuando se elimine el dominio, borra también estos registros en tu proveedor de DNS, como se explica en
Eliminar dominio de la aplicación.Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
VALIDATION_ERROR: Los parámetros de ruta 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).DOMAIN_NOT_FOUND: La aplicación no tiene ningún dominio con ese ID (404).CUSTOM_DOMAIN_RECORD_NOT_FOUND: Los registros DNS del dominio no están disponibles (404). Vuelve a intentarlo en unos minutos; si sigue igual, elimina el dominio y añádelo de nuevo.RATE_LIMIT_EXCEEDED: Se alcanzó el presupuesto de la ruta (429).INTERNAL_SERVER_ERROR: Error inesperado (500).
{
"code": "DOMAIN_NOT_FOUND"
}
{
"code": "CUSTOM_DOMAIN_RECORD_NOT_FOUND"
}
Esta ruta tiene su propio presupuesto de 10 peticiones por minuto. Consulta Límites de peticiones.
Última modificación el 28 de octubre de 2026