Verificar domínio agora

curl

curl -X POST https://app.cubehosting.com.br/api/projects/$PROJECT_ID/domains/$DOMAIN_ID/verify \
  -H "Authorization: Bearer $CUBE_API_KEY"

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

const url = `${API}/projects/${process.env.PROJECT_ID}/domains/${process.env.DOMAIN_ID}/verify`;
const res = await fetch(url, { method: 'POST', headers });
const { domain } = await res.json();
console.log(domain.status, domain.records.map((r) => `${r.type}: ${r.isOk}`));

import os
import requests

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

url = f"{API}/projects/{os.environ['PROJECT_ID']}/domains/{os.environ['DOMAIN_ID']}/verify"
r = requests.post(url, headers=headers, timeout=30)
r.raise_for_status()
print(r.json()["domain"]["status"])

{
  "domain": {
    "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
    "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
    "hostname": "loja.com.br",
    "redirectTo": null,
    "status": "active",
    "error": null,
    "records": [
      {
        "type": "CNAME",
        "name": "loja.com.br",
        "value": "domains.cubehost.dev",
        "isOk": true
      },
      {
        "type": "TXT",
        "name": "_cube-verify.loja.com.br",
        "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
        "isOk": true
      }
    ],
    "verifiedAt": "2026-09-28T15:11:01.597Z",
    "checkedAt": "2026-09-28T15:21:02.114Z",
    "createdAt": "2026-09-28T15:09:40.000Z",
    "project": {
      "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "name": "Loja"
    }
  }
}

POST

projects

{id}

domains

{domainId}

verify

curl

curl -X POST https://app.cubehosting.com.br/api/projects/$PROJECT_ID/domains/$DOMAIN_ID/verify \
  -H "Authorization: Bearer $CUBE_API_KEY"

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

const url = `${API}/projects/${process.env.PROJECT_ID}/domains/${process.env.DOMAIN_ID}/verify`;
const res = await fetch(url, { method: 'POST', headers });
const { domain } = await res.json();
console.log(domain.status, domain.records.map((r) => `${r.type}: ${r.isOk}`));

import os
import requests

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

url = f"{API}/projects/{os.environ['PROJECT_ID']}/domains/{os.environ['DOMAIN_ID']}/verify"
r = requests.post(url, headers=headers, timeout=30)
r.raise_for_status()
print(r.json()["domain"]["status"])

{
  "domain": {
    "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
    "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
    "hostname": "loja.com.br",
    "redirectTo": null,
    "status": "active",
    "error": null,
    "records": [
      {
        "type": "CNAME",
        "name": "loja.com.br",
        "value": "domains.cubehost.dev",
        "isOk": true
      },
      {
        "type": "TXT",
        "name": "_cube-verify.loja.com.br",
        "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
        "isOk": true
      }
    ],
    "verifiedAt": "2026-09-28T15:11:01.597Z",
    "checkedAt": "2026-09-28T15:21:02.114Z",
    "createdAt": "2026-09-28T15:09:40.000Z",
    "project": {
      "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "name": "Loja"
    }
  }
}

A mudança no DNS pode levar alguns minutos para aparecer. Sem o TXT em 7 dias, a Cube para de conferir sozinha (error.code: "verification_expired"); este pedido volta a procurar. Com error.code: "certificate_failed", ele pede o certificado HTTPS de novo, do zero, e o domínio volta a pending.

Erros comuns

Código	HTTP	O que fazer
`too_many_requests`	429	Espere os segundos do `Retry-After` (um pedido a cada 3 s).
`not_found`	404	Confira o `id` do site e o `domainId`.
`insufficient_permission`	403	Use uma chave de leitura e escrita.

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"

domainId

string

obrigatório

O ID do domínio (26 caracteres), de Listar domínios do site.

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

Exemplo:

"01JA9K3M5P7R9T1V3X5Z7B9D1F"

Resposta

O domínio, conferido agora.

domain

object

obrigatório

Um domínio próprio de um site.

Show child attributes

Visão geral

Projetos

Templates

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Verificar domínio agora

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns