API Referencja kodów błędów#

Podstawowy URL: https://api.ideal.house
Wersja: v1
Zaktualizowano: 2026-03-06

📖 Przegląd#

Wszystkie odpowiedzi API mają zjednoczoną strukturę JSON. W przypadku wystąpienia błędu pole code będzie zawierać nieliniowy kod błędu, a pole message dostarczy czytelny opis błędu.

Zjednoczony format odpowiedzi

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

✅ Kod sukcesu#

Przykład

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

❌ Kody błędów#

🔧 Błędy ogólne#

🔐 Błędy uwierzytelniania#

🛡️ Błędy moderacji treści#

💰 Błędy kredytów#

📋 Pełne podsumowanie kodów błędów#

📦 Przykłady odpowiedzi błędów#

1001 — Żądanie zakończone niepowodzeniem#

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

1003 — Błąd wewnętrzny serwera#

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

1011 — Błąd parametru#

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

5002 — Nieprawidłowy klucz API#

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

9010 — Niepowodzenie moderacji treści tekstowej#

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

9038 — Zakazana treść wyjściowa#

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

9051 — Niewystarczające kredyty#

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

💡 Najlepsze praktyki obsługi błędów#

1. Zawsze sprawdzaj code — Nie polegaj wyłącznie na kodach statusu HTTP; zawsze badaj pole code w treści odpowiedzi.
2. Obsługuj 1001 dynamicznie — Jest to ogólny kod błędu; pole message będzie zawierać konkretną przyczynę.
3. Ponawiaj w przypadku 1003 — Błędy po stronie serwera są zwykle przejściowe; wdroż logikę ponawiania z wykładniczym opóźnieniem.
4. Waliduj dane wejściowe przed wysłaniem — Unikaj błędów 1011, walidując wymagane pola po stronie klienta przed wykonaniem wywołania API.
5. Moderacja treści — Jeśli otrzymasz 9010 lub 9038, zweryfikuj swoją treść pod kątem Polityki treści platformy przed ponownym przesłaniem.

© Ideal House AI — Wszelkie prawa zastrzeżone.