Ideal House
Pular para o conteúdo

Credenciais e ambientes#

Requisições AI API usam uma chave API pertencente à sua conta Ideal House API. Mantenha-a no seu servidor e envie no cabeçalho de requisição APIKEY.

Obter uma chave API#

  1. Faça login no Console da AI API.
  2. Abra os controles de chave API e gere ou selecione a chave para a sua integração.
  3. Armazene-a no gerenciador de segredos do servidor ou na configuração de ambiente. Não faça commit no controle de origem nem a inclua em um bundle do navegador.

Ler estes documentos não cria uma chave API nem concede acesso a uma conta.

Configurar o ambiente da solicitação#

Use a URL Base e o caminho de requisição indicado na referência API selecionada. Por exemplo, referências que especificam https://api.ideal.house usam esse host API, não a URL da documentação.

Mantenha a chave API em uma variável de ambiente restrita ao servidor, como IDEALHOUSE_API_KEY. Este é um nome de variável de exemplo para sua aplicação; não é uma configuração SDK. Uma requisição deve incluir o seguinte cabeçalho, com o placeholder substituído no seu servidor:

http
APIKEY: YOUR_API_KEY

Siga o tipo de conteúdo, campos e formato de entrada de imagem exigidos pelo endpoint. Para operações assíncronas, conserve o ID da tarefa retornado e use o endpoint de resultado documentado para essa operação.

Desenvolvimento e produção#

Execute testes locais por meio do seu backend para manter a chave privada. Configure os segredos de implantação antes de publicar e consulte preços, limites de tarefa e deduções de créditos. Solicitações de teste podem usar créditos da conta; estes guias não prometem um sandbox gratuito separado.

Shop ID do Merchant, Publishable Key e Client Secret do Product Import pertencem à integração Visualizer SDK. Eles não substituem uma chave AI API. A configuração Allowed Origins (CORS) do Dashboard do merchant é para a integração do Visualizer, não para a etapa de configuração de requisições AI API no lado do servidor.

Verificar autenticação#

Siga o Início rápido, depois verifique a resposta específica da operação. Se a autenticação falhar, verifique o cabeçalho APIKEY e consulte Códigos de erro. Remova as chaves dos logs e screenshots de suporte.