Hibakódok és állapotok referenciája

Átfogó útmutató a Smart Money API hibakódokhoz, HTTP állapotkódokhoz és hibaelhárítási lépésekhez. Értse meg a hibaválaszokat és oldja meg az integrációs problémákat gyorsan.

2xx Sikeres kódok

A sikeres válaszok azt jelzik, hogy a kérés sikeresen feldolgozásra került.

Kód	Állapot	Jelentés
200	OK	A kérés sikeres. A válasz törzse tartalmazza a kért adatokat.
201	Létrehozva	Az erőforrás sikeresen létrejött. A válasz tartalmazza az új erőforrást.
204	Nincs tartalom	A kérés sikeres, de nincs visszaadandó tartalom (pl. DELETE).

Példa 200 válasz

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx Kliens hibakódok

A kliens hibák azt jelzik, hogy a kérés hibás vagy érvénytelen volt. Javítsa a kérést és próbálja újra.

Kód	Állapot	Ok
400	Hibás kérés	Hibás kérés szintaxis. Ellenőrizze a lekérdezési paramétereket, fejléceket és a kérés törzsét.
401	Jogosulatlan	Hiányzó vagy érvénytelen hitelesítési adatok. Ellenőrizze az API kulcsát vagy JWT tokent.
402	Fizetés szükséges	Az előfizetési fizetése sikertelen volt. Frissítse a számlázási információkat a fiókjában.
403	Tiltott	Hitelesítve, de nincs jogosultsága ehhez az erőforráshoz. A csomagja nem tartalmazza ezt a funkciót.
404	Nem található	Az erőforrás nem létezik. Ellenőrizze a végpont URL-t és a paramétereket.
429	Túl sok kérés	A kéréskorlát túllépve. Várjon, mielőtt újra próbálkozna. Ellenőrizze a Retry-After fejlécet.
422	Feldolgozhatatlan entitás	Az érvényesítés sikertelen. A kérés paraméterei érvénytelenek vagy hiányoznak a kötelező mezők.

Hitelesítési hiba példák

Hiányzó API kulcs (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "A hitelesítési adatok nincsenek megadva.",
    "resolution": "Adja meg az API kulcsot az Authorization fejlécben: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Érvénytelen API kulcs (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Érvénytelen vagy lejárt API kulcs.",
    "resolution": "Hozzon létre egy új API kulcsot a konzoljában a https://smartmoneyapi.com/console címen"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Korlátozás (429)

Ha túllépi az API kvótáját, a szerver 429 Túl sok kérést ad vissza. Ellenőrizze a válaszfejléceket a korlátozási információkhoz:

HTTP fejlécek

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Korlátozási hiba válasz

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "A napi API kéréskorlát (10) túllépve.",
    "resolution": "Frissítsen Trader ($29/hó, 400 kérés/nap) vagy Pro ($79/hó, 4,000 kérés/nap) csomagra.",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Érvényesítési hibák (422)

Az érvényesítési hibák akkor fordulnak elő, ha a kérés paraméterei érvénytelenek vagy hiányoznak a kötelező mezők.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A kérés érvényesítése sikertelen.",
    "details": [
      {
        "field": "symbol",
        "error": "Érvénytelen kereskedési pár. Várt formátum: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Pozitív számnak kell lennie"
      }
    ],
    "resolution": "Javítsa az érvényesítési hibákat és próbálja újra."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx Szerver hibakódok

A szerver hibák a mi oldalunkon jelentkező problémát jelentenek. Ezek átmenetiek és általában gyorsan megoldódnak. Implementáljon exponenciális visszalépéses újrapróbálkozási logikát.

Kód	Állapot	Művelet
500	Belső hiba	Váratlan szerverhiba. Próbálja újra exponenciális visszalépéssel.
502	Hibás átjáró	Átmeneti szolgáltatásmegszakítás. Próbálja újra néhány másodperc múlva.
503	Szolgáltatás nem elérhető	Karbantartás vagy átmeneti leállás. Ellenőrizze az állapotoldalt. Próbálja újra a Retry-After intervallum után.
504	Átjáró időtúllépés	A kérés túl sokáig tartott. A szerver lehet, hogy feldolgozta. Ellenőrizze az idempotenciát.

Szerverhiba példa (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "A szolgáltatás átmenetileg nem elérhető karbantartás miatt.",
    "resolution": "Kérjük, próbálja újra 5 perc múlva. Kövesse az állapotot a https://status.smartmoneyapi.com címen"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Hibaelhárítási útmutató

401 Jogosulatlan - Érvénytelen API kulcs

Probléma: 401 hibák érkeznek még API kulcs mellett is.

Megoldások:

Ellenőrizze, hogy az API kulcs szerepel-e az Authorization fejlécben "Bearer" előtaggal
Ellenőrizze, hogy az API kulcsa nem járt-e le vagy vonható-e vissza
Győződjön meg arról, hogy a megfelelő kulcsot használja (termelési, tesztelési vagy fejlesztési)
Hozzon létre egy új API kulcsot a konzoljából, ha az aktuális elveszett

403 Tiltott - Funkció nem elérhető

Probléma: 403 hibák érkeznek bizonyos végpontokon.

Megoldások:

Ellenőrizze az API szintjét. Egyes végpontokhoz Trader vagy Pro csomag szükséges
Frissítsen csomagot a /pricing.html címen a prémium funkciók eléréséhez
Ellenőrizze, hogy az API kulcs rendelkezik-e a szükséges jogosultságokkal
Lépjen kapcsolatba az ügyfélszolgálattal, ha úgy gondolja, hogy hozzáférése lenne

429 Túl sok kérés - Korlátozva

Probléma: 429 hibák érkeznek és korlátozva van.

Megoldások:

Implementáljon exponenciális visszalépéses újrapróbálkozási logikát (várjon 1s, 2s, 4s stb.)
Gyorsítótárazza a válaszokat, hogy elkerülje a redundáns API hívásokat
Használjon WebSocket-et valós idejű adatokhoz a REST végpontok lekérdezése helyett
Frissítsen csomagot magasabb kvótákért (Trader 1,000/nap, Pro 5,000/nap)
Csoportosítsa több lekérdezést egyetlen kérésbe, ahol lehetséges

400 Hibás kérés - Érvénytelen paraméterek

Probléma: 400 hibák érkeznek hibás kérésekkel.

Megoldások:

Ellenőrizze az API dokumentációt a kötelező és opcionális paraméterekhez
Ellenőrizze a paraméterek típusát (szövegek vs számok, tömbök vs objektumok)
Győződjön meg arról, hogy a JSON érvényes és megfelelően formázott
Használja a helyes végpont URL-eket a megfelelő útvonalparaméterekkel
Ellenőrizd a lekérdezési paraméterek neveiben a helyesírási hibákat.

5xx Szerverhibák – Ideiglenes kimaradások

Probléma: 500, 502, 503 vagy 504 hibák megjelenése.

Megoldások:

Ellenőrizd a szolgáltatás állapotát a https://status.smartmoneyapi.com oldalon.
Valósíts meg automatikus újrapróbálkozást exponenciális visszalépéssel (max 5-10 próba).
Várj 30-60 másodpercet a 503 hibák újrapróbálkozása előtt.
Használd a Retry-After fejlécet az újrapróbálkozás időzítésének meghatározásához.
Iratkozz fel az állapotoldalra az incidensértesítésekhez.

Hibaválasz formátuma

Minden hibaválasz következetes formátumú:

JSON

{ "success": false, "error": { "code": "ERROR_CODE", "message": "Ember által olvasható hibaüzenet", "details": {...}, "resolution": "A probléma megoldásának lépései" }, "timestamp": "2026-03-21T14:35:22Z" }

További segítségre van szükséged?

Nézd meg az API dokumentációt vagy lépj kapcsolatba az ügyfélszolgálattal a hibakódod és a kérés részleteivel.

API Referencia

Kapcsolatfelvétel

Kérdéseid vannak? Nézd meg a dokumentációt vagy fordulj az ügyfélszolgálathoz.

Konzol megnyitása