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 à 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/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 à contact@iacrea.com