Pular para o conteúdo principal
POST
curl
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. Na raiz com ALIAS (ou CNAME achatado) o certificado HTTPS não sai, e o domínio fica error com error.code: "root_alias_unsupported" e a explicação (veja Domínio na raiz). pendingReason segue no formato, sempre null hoje.

Erros comuns

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_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.

Scopes

domains:write

Parâmetros de caminho

id
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 (no exemplo, a raiz com ALIAS, em que o certificado não sai).

domain
object
obrigatório

Um domínio próprio de um site.