Ideal House
Aller au contenu principal

Identifiants et environnements#

Les requêtes AI API utilisent une clé API appartenant à votre compte API Ideal House. Conservez-la sur votre serveur et envoyez-la dans l'en-tête de requête APIKEY.

Obtenir une clé API#

  1. Connectez-vous à la Console AI API.
  2. Ouvrez les contrôles de clé API et générez ou sélectionnez la clé pour votre intégration.
  3. Stockez-la dans le gestionnaire de secrets de votre serveur ou dans la configuration de l'environnement. Ne la commitez pas dans le contrôle de source ni ne l'incluez dans un bundle navigateur.

La lecture de ces documents ne crée pas de clé API ni n'accorde l'accès à un compte.

Configurer l'environnement de requête#

Utilisez l’URL de base et le chemin de requête indiqués dans la référence API sélectionnée. Par exemple, les références qui spécifient https://api.ideal.house utilisent cet hôte API, et non l'URL de la documentation.

Conservez la clé API dans une variable d'environnement accessible uniquement par le serveur, telle que IDEALHOUSE_API_KEY. Il s'agit d'un nom de variable d'exemple pour votre application ; ce n'est pas un paramètre SDK. Une requête doit inclure l'en-tête suivant, avec l'espace réservé remplacé sur votre serveur :

http
APIKEY: YOUR_API_KEY

Respectez le type de contenu requis, les champs et le format d'entrée d'image du point de terminaison. Pour les opérations asynchrones, conservez l'ID de tâche retourné et utilisez le point de terminaison de résultat documenté pour cette opération.

Développement et production#

Exécutez les tests locaux via votre backend afin que la clé reste privée. Configurez vos secrets de déploiement avant la mise en production, et consultez tarification, limites de tâches et déductions de crédits. Les requêtes de test peuvent utiliser les crédits de compte ; ces guides ne promettent pas de bac à sable gratuit séparé.

Le Shop ID du marchand, la Publishable Key et le Client Secret d'importation de produits relèvent de l'intégration Visualizer SDK. Ils ne remplacent pas une clé AI API. Le paramètre Allowed Origins (CORS) du tableau de bord marchand est destiné à l'intégration Visualizer, et non à l'étape de configuration des requêtes AI API côté serveur.

Vérifier l'authentification#

Suivez le Démarrage rapide, puis vérifiez la réponse spécifique à l'opération. Si l'authentification échoue, vérifiez l'en-tête APIKEY et consultez les codes d'erreur. Supprimez les clés des journaux et des captures d'écran de support.