Référence des codes d'erreur API#

URL de base : https://api.ideal.house
Version : v1
Mis à jour : 2026-03-06

📖 Vue d'ensemble#

Toutes les réponses API suivent une structure JSON unifiée. Lorsqu'une erreur se produit, le champ code contiendra un code d'erreur non nul, et le champ message fournira une description lisible du message d'erreur.

Format de réponse unifié

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

✅ Code de succès#

Exemple

{
  "code": 0,
  "message": "success",
  "data": { }
}

❌ Codes d'erreur#

🔧 Erreurs générales#

🔐 Erreurs d'authentification#

🛡️ Erreurs de modération de contenu#

💰 Erreurs liées aux crédits#

📋 Récapitulatif complet des codes d'erreur#

📦 Exemples de réponses d'erreur#

1001 — Échec de la requête#

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

1003 — Erreur interne du serveur#

{
  "code": 1003,
  "message": "Internal server error",
  "data": null
}

1011 — Erreur de paramètre#

{
  "code": 1011,
  "message": "Request parameter error: imageUrl is required",
  "data": null
}

5002 — Clé API invalide#

{
  "code": 5002,
  "message": "Invalid API Key",
  "data": null
}

9010 — Échec de la modération de contenu textuel#

{
  "code": 9010,
  "message": "Text prompt failed content review, contains prohibited content",
  "data": null
}

9038 — Contenu interdit dans la sortie#

{
  "code": 9038,
  "message": "Prohibited content",
  "data": null
}

9051 — Crédits insuffisants#

{
  "code": 9051,
  "message": "Insufficient coins",
  "data": null
}

💡 Bonnes pratiques pour la gestion des erreurs#

1. Vérifiez toujours code — Ne vous fiez pas uniquement aux codes de statut HTTP ; inspectez systématiquement le champ code dans le corps de la réponse.
2. Gérez dynamiquement 1001 — Il s'agit d'un code d'erreur générique ; le champ message contiendra la raison spécifique.
3. Réessayez en cas d'erreur 1003 — Les erreurs côté serveur sont généralement transitoires ; implémentez de nouvelles tentatives avec un délai qui augmente de façon exponentielle.
4. Validez les entrées avant envoi — Évitez les erreurs 1011 en validant les champs obligatoires côté client avant d'appeler l'API.
5. Modération de contenu — Si vous recevez 9010 ou 9038, examinez votre contenu au regard de la Politique de contenu de la plateforme avant de le resoumettre.

© Ideal House AI — Tous droits réservés.