Ideal House
Saltar al contenido

Credenciales y entornos#

Las solicitudes de AI API usan una clave API perteneciente a su cuenta de Ideal House API. Mantenla en tu servidor y envíala en el encabezado de solicitud APIKEY.

Obtener una clave API#

  1. Inicie sesión en la Consola de AI API.
  2. Abra los controles de clave API y genere o seleccione la clave para su integración.
  3. Guárdela en el administrador de secretos de su servidor o en la configuración del entorno. No la añada al repositorio de código fuente ni la incluya en un paquete para navegador.

Leer estos documentos no crea una clave API ni otorga acceso a una cuenta.

Configurar el entorno de solicitud#

Use la URL base y la ruta de solicitud indicadas en la referencia de API seleccionada. Por ejemplo, las referencias que especifican https://api.ideal.house usan ese host de API, no la URL de documentación.

Mantenga la clave API en una variable de entorno solo para servidor, como IDEALHOUSE_API_KEY. Este es un nombre de variable de ejemplo para su aplicación; no es una configuración de SDK. Una solicitud debe incluir el siguiente encabezado, con el marcador de posición reemplazado en su servidor:

http
APIKEY: YOUR_API_KEY

Siga el tipo de contenido requerido por el punto de conexión, los campos y el formato de entrada de imagen. Para operaciones asíncronas, conserve el ID de tarea devuelto y use el punto de conexión de resultados documentado para esa operación.

Desarrollo y producción#

Ejecute pruebas locales a través de su backend para que la clave permanezca privada. Configure los secretos de implementación antes de publicar y consulte precios, límites de tarea y deducciones de créditos. Las solicitudes de prueba pueden usar créditos de cuenta; estas guías no prometen un sandbox gratuito separado.

El Shop ID, el Publishable Key y el Client Secret de importación de productos para comerciantes pertenecen a la integración de Visualizer SDK. No reemplazan una clave de AI API. La configuración Allowed Origins (CORS) del Panel de control del comerciante es para la integración del Visualizador, no para el paso de configuración de las solicitudes de AI API del lado del servidor.

Verificar autenticación#

Siga Inicio rápido, luego verifique la respuesta específica de la operación. Si la autenticación falla, verifique el encabezado APIKEY y consulte los códigos de error. Quite las claves de los registros y las capturas de pantalla de soporte.