Domínio Personalizado

Listar domínios customizados

get

Retorna todos os domínios customizados do usuário autenticado.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Lista de domínios customizados retornada com sucesso

application/json

anyOptional

401

Erro de autenticação

application/json

get

/customdomain/all

HTTPcURLJavaScriptPython

GET /v2/customdomain/all HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "domains": [
    {
      "id": "example.com",
      "dns_status": "active",
      "date": 1745100000000,
      "isLegacy": false,
      "app": {
        "id": "1719010867306",
        "name": "example.com",
        "online": true,
        "type": 1
      },
      "instructions": [
        {
          "type": "A",
          "name": "example.com",
          "content": "192.0.2.1"
        }
      ]
    }
  ]
}

Criar domínio customizado

post

Cria um novo domínio customizado e vincula a um app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

application/json

domainNamestringRequired

Nome desejado para o domínio customizado

appIDstringRequired

ID do app para vincular

Responses

200

Domínio customizado criado com sucesso

application/json

anyOptional

400

Formato de domínio inválido

application/json

401

Erro de autenticação

application/json

403

Limite do plano atingido

application/json

404

App não encontrado

application/json

409

Domínio já registrado ou app já possui domínio customizado

application/json

500

Erro na API externa

application/json

post

/customdomain/create

HTTPcURLJavaScriptPython

POST /v2/customdomain/create HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "domainName": "text",
  "appID": "text"
}

{
  "status": "ok",
  "message": "Domínio customizado registrado com sucesso",
  "domain": {
    "id": "example.com",
    "dns_status": "pending_check",
    "instructions": [
      {
        "type": "A",
        "name": "example.com",
        "content": "192.0.2.1"
      }
    ],
    "app": {
      "id": "1719010867306",
      "name": "1719010867306.discloud.app"
    }
  }
}

Editar vínculo de domínio customizado

put

Move um domínio customizado para outro app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Domínio customizado a ser movido

Body

application/json

newAppIDstringRequired

Novo ID do app

Responses

200

Domínio customizado editado com sucesso

application/json

statusstringOptional

messagestringOptional

migratedbooleanOptional

domainstringOptional

400

Operação inválida

application/json

401

Erro de autenticação

application/json

403

Sem permissão

application/json

404

Domínio ou app não encontrado

application/json

409

App já possui outro domínio customizado

application/json

500

Erro na migração

application/json

put

/customdomain/{domainName}/edit

HTTPcURLJavaScriptPython

PUT /v2/customdomain/{domainName}/edit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "newAppID": "text"
}

{
  "status": "ok",
  "message": "Domínio editado com sucesso",
  "migrated": false,
  "domain": "example.com"
}

Remover domínio customizado

delete

Remove um domínio customizado do usuário e desvincula do app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Domínio customizado a ser removido

Responses

200

Domínio customizado removido com sucesso

application/json

statusstringOptional

messagestringOptional

domainstringOptional

401

Erro de autenticação

application/json

403

Sem permissão

application/json

404

Domínio não encontrado

application/json

500

Erro na API externa

application/json

delete

/customdomain/{domainName}/remove

HTTPcURLJavaScriptPython

DELETE /v2/customdomain/{domainName}/remove HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Domínio removido com sucesso",
  "domain": "example.com"
}

Verificar DNS do domínio customizado

get

Verifica o status DNS de um domínio customizado em tempo real.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

domainNamestringRequired

Domínio customizado a ser verificado

Responses

200

Status DNS retornado com sucesso

application/json

statusstringOptional

401

Erro de autenticação

application/json

403

Sem permissão

application/json

404

Domínio não encontrado

application/json

500

Erro na API externa

application/json

get

/customdomain/{domainName}/verify

HTTPcURLJavaScriptPython

GET /v2/customdomain/{domainName}/verify HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "domain": {
    "id": "example.com",
    "dns_status": "active",
    "valid": true,
    "message": "DNS configurado corretamente",
    "app": {
      "id": "1719010867306",
      "name": "example.com",
      "online": true
    }
  }
}