Subdominio

Listar subdomínios

get

Retorna todos os subdomínios do usuário autenticado. Requer plano Platinum ou superior.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Lista de subdomínios retornada com sucesso

application/json

anyOptional

401

Erro de autenticação

application/json

403

Plano insuficiente

application/json

get/subdomain/all

HTTPcURLJavaScriptPython

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

{
  "status": "ok",
  "subdomains": [
    {
      "id": "meu-subdomain",
      "userID": "803658045736878080",
      "status": 1,
      "date": 1745100000000
    }
  ]
}

Obter subdomínio

get

Retorna as informações de um subdomínio específico do usuário. Requer plano Platinum ou superior.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

subdomainNamestringRequired

Nome do subdomínio (sem o sufixo .discloud.app)

Responses

200

Subdomínio retornado com sucesso

application/json

anyOptional

401

Erro de autenticação

application/json

403

Plano insuficiente ou sem permissão

application/json

404

Subdomínio não encontrado

application/json

get/subdomain/{subdomainName}

HTTPcURLJavaScriptPython

GET /v2/subdomain/{subdomainName} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "subdomain": {
    "id": "meu-subdomain",
    "userID": "803658045736878080",
    "status": 1,
    "date": 1745100000000
  }
}

Criar subdomínio

post

Cria um novo subdomínio. Requer plano Platinum ou superior. Máximo de 100 subdomínios por usuário.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

subdomainNamestringRequired

Nome desejado para o subdomínio (sem o sufixo .discloud.app)

Pattern: ^[a-z0-9-]{2,20}$

Responses

201

Subdomínio criado com sucesso

application/json

anyOptional

400

Nome de subdomínio inválido ou palavra inapropriada

application/json

401

Erro de autenticação

application/json

403

Plano insuficiente ou limite atingido

application/json

409

Subdomínio já registrado

application/json

post/subdomain/{subdomainName}

HTTPcURLJavaScriptPython

POST /v2/subdomain/{subdomainName} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Subdomínio criado com sucesso",
  "subdomain": {
    "id": "meu-subdomain",
    "userID": "803658045736878080",
    "status": 1,
    "date": 1745100000000
  }
}

Remover subdomínio

delete

Remove um subdomínio do usuário. Não é possível remover subdomínios que estejam em uso (status 2). Requer plano Platinum ou superior.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

subdomainNamestringRequired

Nome do subdomínio a ser removido

Responses

200

Subdomínio removido com sucesso

application/json

statusstringOptional

messagestringOptional

401

Erro de autenticação

application/json

403

Plano insuficiente ou sem permissão

application/json

404

Subdomínio não encontrado

application/json

409

Subdomínio em uso

application/json

delete/subdomain/{subdomainName}

HTTPcURLJavaScriptPython

DELETE /v2/subdomain/{subdomainName} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Subdomínio removido com sucesso"
}