Ideal House
Passa al contenuto

Credenziali e ambienti#

Le richieste AI API usano una chiave API appartenente al tuo account Ideal House API. Conservala sul server e inviala nell’intestazione APIKEY della richiesta.

Ottenere una chiave API#

  1. Accedi alla pannello AI API.
  2. Apri i controlli delle chiavi API e genera o seleziona la chiave per l’integrazione.
  3. Conservala nel gestore dei segreti o nella configurazione dell’ambiente del server. Non salvarla nel controllo di versione né includerla in un pacchetto per il browser.

La lettura di questi documenti non crea una chiave API né concede l’accesso a un account.

Configurare l’ambiente delle richieste#

Usa l’URL di base e il percorso indicati nella documentazione API selezionata. Ad esempio, le guide che specificano https://api.ideal.house usano quell’host API, non l’URL della documentazione.

Conserva la chiave API in una variabile d’ambiente accessibile solo sul server, come IDEALHOUSE_API_KEY. È un nome di variabile di esempio per l’applicazione, non un’impostazione di SDK. La richiesta deve includere la seguente intestazione, sostituendo il segnaposto sul server:

http
APIKEY: YOUR_API_KEY

Rispetta il tipo di contenuto, i campi e il formato delle immagini richiesti dall’endpoint. Per le operazioni asincrone, conserva l’ID attività restituito e usa l’endpoint dei risultati documentato per quell’operazione.

Sviluppo e produzione#

Esegui le prove locali tramite il tuo sistema lato server per mantenere riservata la chiave. Configura i segreti di distribuzione prima di pubblicare e controlla prezzi, limiti delle attività e deduzioni dei crediti. Le richieste di prova possono consumare crediti dell’account; queste guide non promettono un ambiente di prova gratuito separato.

Shop ID, Publishable Key e Client Secret per l’importazione dei prodotti del commerciante appartengono all’integrazione Visualizer SDK. Non sostituiscono una chiave AI API. L’impostazione Allowed Origins (CORS) nel pannello di controllo del commerciante riguarda l’integrazione Visualizer, non la configurazione delle richieste AI API lato server.

Verificare l’autenticazione#

Segui la guida rapida, poi controlla la risposta specifica dell’operazione. Se l’autenticazione non riesce, verifica l’intestazione APIKEY e consulta i codici di errore. Rimuovi le chiavi dai registri e dagli screenshot per l’assistenza.