Passer au contenu principal

​
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 à [email protected].

​
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 à [email protected] 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 à [email protected] 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/account/credit' \
--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

Documentation API complète

Consultez notre documentation API détaillée pour tous les endpoints disponibles

FAQ

Trouvez des réponses aux questions fréquemment posées
Besoin d’aide pour l’intégration ? Contactez notre équipe de support à [email protected]