Riferimento dei codici di errore API#

URL di base: https://api.ideal.house
Versione: v1
Aggiornato: 2026-03-06

📖 Panoramica#

Tutte le risposte API seguono una struttura JSON unificata. Quando si verifica un errore, il campo code contiene un codice di errore diverso da zero e il campo message fornisce una descrizione dell'errore leggibile dalle persone.

Formato unificato della risposta

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

✅ Codice di successo#

Esempio

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

❌ Codici di errore#

🔧 Errori generali#

🔐 Errori di autenticazione#

🛡️ Errori di moderazione dei contenuti#

💰 Errori relativi ai crediti#

📋 Riepilogo completo dei codici di errore#

📦 Esempi di risposte di errore#

1001 — Richiesta non riuscita#

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

1003 — Errore interno del server#

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

1011 — Errore nei parametri#

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

5002 — Chiave API non valida#

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

9010 — Moderazione del contenuto testuale non superata#

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

9038 — Contenuto vietato nell'output#

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

9051 — Crediti insufficienti#

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

💡 Buone pratiche per la gestione degli errori#

1. Controlla sempre code — Non affidarti soltanto ai codici di stato HTTP; esamina sempre il campo code nel corpo della risposta.
2. Gestisci 1001 dinamicamente — Questo è un codice di errore generico; il campo message contiene il motivo specifico.
3. Riprova in caso di 1003 — Gli errori del server sono solitamente transitori; implementa una logica di nuovi tentativi con attesa esponenziale.
4. Convalida gli input prima dell'invio — Evita gli errori 1011 convalidando i campi obbligatori sul client prima di effettuare la chiamata API.
5. Moderazione dei contenuti — Se ricevi 9010 o 9038, verifica i tuoi contenuti rispetto alla Politica sui contenuti della piattaforma prima di inviarli nuovamente.

© Ideal House AI — Tutti i diritti riservati.