curl -X POST 'https://api.sondercloud.app/v1/apps/{id}/domain' \
-H 'Authorization: Bearer seu_token' \
-H 'Content-Type: application/json' \
-d '{
"domain": "api.zynxapplications.com.br"
}'
{
"status": "success",
"code": "DOMAIN_SET",
"response": {
"customDomain": "api.zynxapplications.com.br",
"subdomain": "zynx-api.sondercloud.app",
"status": "pending_verification",
"dnsRecords": [
{
"type": "CNAME",
"name": "api.zynxapplications.com.br",
"value": "zynx-api.sondercloud.app",
"ttl": "3600"
}
],
"instructions": "Crie o registro CNAME acima no seu provedor de DNS e aguarde a propagação."
}
}
Domínios
Configurar Domínio Customizado
Aponta um domínio próprio para o subdomínio existente da aplicação
POST
/
v1
/
apps
/
{id}
/
domain
curl -X POST 'https://api.sondercloud.app/v1/apps/{id}/domain' \
-H 'Authorization: Bearer seu_token' \
-H 'Content-Type: application/json' \
-d '{
"domain": "api.zynxapplications.com.br"
}'
{
"status": "success",
"code": "DOMAIN_SET",
"response": {
"customDomain": "api.zynxapplications.com.br",
"subdomain": "zynx-api.sondercloud.app",
"status": "pending_verification",
"dnsRecords": [
{
"type": "CNAME",
"name": "api.zynxapplications.com.br",
"value": "zynx-api.sondercloud.app",
"ttl": "3600"
}
],
"instructions": "Crie o registro CNAME acima no seu provedor de DNS e aguarde a propagação."
}
}
curl -X POST 'https://api.sondercloud.app/v1/apps/{id}/domain' \
-H 'Authorization: Bearer seu_token' \
-H 'Content-Type: application/json' \
-d '{
"domain": "api.zynxapplications.com.br"
}'
{
"status": "success",
"code": "DOMAIN_SET",
"response": {
"customDomain": "api.zynxapplications.com.br",
"subdomain": "zynx-api.sondercloud.app",
"status": "pending_verification",
"dnsRecords": [
{
"type": "CNAME",
"name": "api.zynxapplications.com.br",
"value": "zynx-api.sondercloud.app",
"ttl": "3600"
}
],
"instructions": "Crie o registro CNAME acima no seu provedor de DNS e aguarde a propagação."
}
}
Corpo da Requisição
string
required
Domínio a ser apontado para a aplicação. Aceito com ou sem
http(s):// — a API normaliza (remove protocolo, barras finais, e converte para minúsculas).Campos da Resposta
string
Sempre
pending_verification na criação — o CNAME ainda precisa ser criado e propagado no provedor de DNS do domínio.A aplicação precisa já ter um subdomínio configurado. Sem isso, a requisição falha com
400.Configurar um domínio customizado reinicia a aplicação automaticamente para aplicar a mudança.
Um domínio só pode estar vinculado a uma aplicação por vez. Tentar reutilizar um
domain já configurado em outra aplicação retorna 400.Authorizations
Token de API da SonderCloud, enviado no header Authorization: Bearer <token>
Path Parameters
ID do app
Body
application/json
Domínio a ser apontado para a aplicação, com ou sem protocolo.
Example:
"api.meusite.com"