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 1 registro 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": {
        "descricao": "Para ativar o certificado SSL e concluir o apontamento do seu domínio, siga as instruções abaixo no painel DNS do seu provedor de domínio.",
        "subdominios": {
            "quando_usar": "Utilize esta opção se o domínio for algo como app.seudominio.com ou painel.seudominio.com",
            "registro": {
                "tipo": "CNAME",
                "valor": "rota.tenanci.com"
            }
        },
        "dominio_apex": {
            "quando_usar": "Utilize esta opção se o domínio for o domínio principal, como seudominio.com (sem www ou subdomínio)",
            "registro": {
                "tipo": "A",
                "valor": "109.224.228.119"
            }
        },
        "observacoes_importantes": [
            "Não ative proxy ou CDN (como o proxy laranja do Cloudflare). Apenas realize o apontamento DNS.",
            "A emissão do certificado SSL acontece automaticamente após a propagação do DNS.",
            "Assim que o certificado for emitido, o roteamento será ativado sem necessidade de ação adicional.",
            "No momento, a Tenanci ainda não possui um webhook para notificar quando o domínio estiver ativo.",
            "Você pode consultar o status do domínio a qualquer momento através do endpoint: https://api.tenanci.com/projects/{projectId}/domains/{domainId}"
        ]
    }
}

Página anterior

Obter um Domínio Específico

Próxima página

Atualizar um Domínio