Guide de démarrage rapide

Ce guide vous aidera à commencer rapidement avec IACrea et à intégrer notre API à vos applications. Pour accéder à notre API, vous devez obligatoirement contacter notre support à contact@iacrea.com.

Création de votre compte développeur

1

Inscrivez-vous

Rendez-vous sur IACrea.com et créez votre compte en fournissant vos informations professionnelles.

2

Vérifiez votre email

Confirmez votre compte en cliquant sur le lien que nous vous envoyons par email.

3

Contactez notre support

Envoyez un email à contact@iacrea.com pour demander l’activation de l’accès API pour votre compte. Précisez votre cas d’utilisation et vos besoins spécifiques.

4

Accédez à votre Espace développeur

Une fois l’accès API activé par notre équipe, connectez-vous à votre compte et accédez à la section “Espace développeur” pour récupérer votre clé API.

L’accès à l’API est soumis à validation par notre équipe. Contactez-nous à contact@iacrea.com pour discuter de vos besoins spécifiques et obtenir les informations concernant les forfaits disponibles.

Configuration de votre environnement API

1

Récupérez votre clé API

Dans votre Espace Développeur sur le site d’IACrea, récupérez votre clé API unique. Cette clé doit rester confidentielle et ne pas être partagée.

# Exemple d'authentification avec votre clé API
x-api-key: votre-clé-api
2

Testez la connexion

Vérifiez que votre configuration fonctionne en récupérant le nombre de photos restantes sur votre compte.

curl --request POST \
--url 'https://iacrea.com/api/photos/remaining' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id"
}'

Intégration des services IACrea

Notre API offre plusieurs services que vous pouvez intégrer dans votre application :

curl --request POST \
--url 'https://iacrea.com/api/renovate/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "photo_360": false
}'

Récupération des résultats

Comme nos services fonctionnent de manière asynchrone, vous avez deux options pour obtenir les résultats :

Option 1 : Webhook (recommandé)

Fournissez une URL de webhook lors de l’appel initial, et nous vous notifierons automatiquement lorsque le traitement sera terminé.

curl --request POST \
--url 'https://iacrea.com/api/renovate/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "webhook": "https://votre-serveur.com/webhooks/iacrea"
}'

Option 2 : Polling

Interrogez régulièrement l’API de récupération jusqu’à ce que le statut soit “SUCCEEDED” ou “FAILED”.

curl --request POST \
--url 'https://iacrea.com/api/renovate/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-recu-lors-de-la-generation"
}'

Bonnes pratiques d’intégration

  • Gestion des erreurs : Implémentez un système robuste de gestion des erreurs pour traiter les réponses d’erreur de l’API
  • Cache des images : Stockez les URL d’images générées pour éviter de refaire des appels inutiles
  • Monitoring : Suivez régulièrement votre consommation de crédits via l’API de photos restantes
  • Timeout : Configurez des timeouts appropriés, car le traitement peut prendre plusieurs minutes

Ressources supplémentaires

Besoin d’aide pour l’intégration ? Contactez notre équipe de support à contact@iacrea.com