Criar um Domínio

POST

https://api.tenanci.com/projects/{projectId}/domains

Cria um novo domínio associado a um projeto.
Ao criar um domínio, você receberá um response com as instruções para adicionar 2 registros ao DNS do domínio. Após inserir o registro o sistema da Tenanci irá realizar a verificação de forma automática e emitir o certificado ssl e ativar o roteamento. Importante, nunca excluir o registro DNS, pois o sistema de renovação utiliza o mesmo valor de desafio para renovar o certificado.

Requisição

Authorization

Adicionar parâmetro em header

X-API-Key

Exemplo:

X-API-Key: ********************

Parâmetros de Caminho

Parâmetros Bodyapplication/json

Exemplo

{
  "cliente": {
    "dominio": "exemplo.tenanci.com",
    "dominio_apex": false,
    "favicon": true,
    "favicon_url": "site-do-cliente.com/favicon.ico",
    "nome": "Cliente de Exemplo",
    "usa_config_personalizada": true
  },
  "request_config": {
    "api_services_ativo": false,
    "custom_headers_ativo": true,
    "custom_html_ativo": true,
    "custom_path_ativo": true,
    "proxy_paths": [
      {
        "origem": "/api",
        "destino": "https://api-externa.com"
      }
    ],
    "custom_headers": [
      {
        "nome": "X-Teste1",
        "valor": "Valor-Teste1"
      },
      {
        "nome": "X-Teste2",
        "valor": "Valor-Teste2"
      },
      {
        "nome": "X-Teste3",
        "valor": "Valor-Teste3"
      }
    ],
    "html_content": [
      {
        "conteudo": "<script>console.log('teste')</script>",
        "local_da_injecao": "head"
      }
    ]
  }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tenanci.com/projects/1756730976729x534244760090711700/domains' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "cliente": {
    "dominio": "exemplo.tenanci.com",
    "dominio_apex": false,
    "favicon": true,
    "favicon_url": "site-do-cliente.com/favicon.ico",
    "nome": "Cliente de Exemplo",
    "usa_config_personalizada": true
  },
  "request_config": {
    "api_services_ativo": false,
    "custom_headers_ativo": true,
    "custom_html_ativo": true,
    "custom_path_ativo": true,
    "proxy_paths": [
      {
        "origem": "/api",
        "destino": "https://api-externa.com"
      }
    ],
    "custom_headers": [
      {
        "nome": "X-Teste1",
        "valor": "Valor-Teste1"
      },
      {
        "nome": "X-Teste2",
        "valor": "Valor-Teste2"
      },
      {
        "nome": "X-Teste3",
        "valor": "Valor-Teste3"
      }
    ],
    "html_content": [
      {
        "conteudo": "<script>console.log('\''teste'\'')</script>",
        "local_da_injecao": "head"
      }
    ]
  }
}'

Respostas

🟢201create-domain

application/json

Body

Exemplo

{
    "mensagem": "Domínio adicionado com sucesso!",
    "id_cliente": "1758071004477x135789091166001800",
    "certificado_ssl": {
        "instrucoes": "Por favor, adicione o seguinte registro DNS no provedor do seu domínio:",
        "registro_dns": {
            "tipo": "TXT",
            "nome": "_acme-challenge.exemplo.tenanci.com",
            "valor": "6nkCM7-8_ihid8BaLaK9KvEPwgjbDcg31C0a2anbZhE",
            "ttl": "120"
        },
        "observacao": "Certifique-se de que o registro seja adicionado corretamente para garantir a emissão do certificado SSL. Assim que o certificado for emitido o roteamento será ativado."
    }
}

Modificado em 2025-11-02 15:53:24

Página anterior

Obter um Domínio Específico

Próxima página

Atualizar um Domínio