Ideal House
Naar inhoud gaan

Toegangsgegevens en omgevingen#

AI API-verzoeken gebruiken een API-sleutel van je Ideal House API-account. Bewaar deze op je server en stuur deze mee in de verzoekheader APIKEY.

Een API-sleutel verkrijgen#

  1. Meld je aan bij de beheerconsole van AI API.
  2. Open het beheer van API-sleutels en maak of selecteer de sleutel voor je integratie.
  3. Bewaar deze in het geheimenbeheer of de omgevingsconfiguratie van je server. Neem de sleutel niet op in versiebeheer of in een browserbundel.

Door deze documentatie te lezen wordt geen API-sleutel aangemaakt en krijg je geen toegang tot een account.

De verzoekomgeving instellen#

Gebruik de basis-URL en het verzoekpad uit de gekozen API-referentie. Referenties die bijvoorbeeld https://api.ideal.house vermelden, gebruiken die API-host en niet de documentatie-URL.

Bewaar de API-sleutel in een omgevingsvariabele die uitsluitend op de server beschikbaar is, zoals IDEALHOUSE_API_KEY. Dit is een voorbeeldnaam voor je toepassing, geen instelling van SDK. Een verzoek moet de volgende header bevatten; vervang de tijdelijke waarde op je server:

http
APIKEY: YOUR_API_KEY

Volg het vereiste inhoudstype, de velden en het formaat voor beeldinvoer van het endpoint. Bewaar bij asynchrone bewerkingen de geretourneerde taak-ID en gebruik het resultaatendpoint dat voor die bewerking is beschreven.

Ontwikkeling en productie#

Voer lokale tests via je backend uit zodat de sleutel privé blijft. Configureer je implementatiegeheimen vóór publicatie en controleer prijzen, taaklimieten en creditafschrijving. Testverzoeken kunnen accountcredits verbruiken; deze handleidingen beloven geen aparte gratis testomgeving.

De Shop ID, Publishable Key en Product Import Client Secret voor handelaren horen bij de Visualizer SDK-integratie. Ze vervangen geen AI API-sleutel. De instelling Allowed Origins (CORS) in het handelaarsdashboard is bedoeld voor de Visualizer-integratie en is geen configuratiestap voor AI API-verzoeken vanaf de server.

Authenticatie controleren#

Volg de snelstart en controleer daarna het antwoord van de specifieke bewerking. Als authenticatie mislukt, controleer dan de header APIKEY en raadpleeg de foutcodes. Verwijder sleutels uit logboeken en schermafbeeldingen voor ondersteuning.