Chybové kódy a reference stavů
Komplexní průvodce chybovými kódy Smart Money API, HTTP stavovými kódy a kroky pro řešení problémů. Porozumějte chybovým odpovědím a rychle řešte problémy s integrací.
2xx Úspěšné kódy
Úspěšné odpovědi indikují, že požadavek byl úspěšně zpracován.
| Kód | Stav | Význam |
|---|---|---|
| 200 | OK | Požadavek byl úspěšný. Tělo odpovědi obsahuje požadovaná data. |
| 201 | Vytvořeno | Zdroj byl úspěšně vytvořen. Odpověď obsahuje nový zdroj. |
| 204 | Žádný obsah | Požadavek byl úspěšný, ale není žádný obsah k vrácení (např. DELETE). |
Příklad odpovědi 200
JSON
{
"success": true,
"data": {
"total": 42,
"positions": [...],
"pagination": {
"page": 1,
"limit": 50
}
},
"timestamp": "2026-03-21T14:35:22Z"
}
4xx Chyby klienta
Chyby klienta indikují, že požadavek byl chybně vytvořen nebo neplatný. Opravte svůj požadavek a zkuste to znovu.
| Kód | Stav | Příčina |
|---|---|---|
| 400 | Chybný požadavek | Chybná syntaxe požadavku. Zkontrolujte parametry dotazu, hlavičky a tělo požadavku. |
| 401 | Neoprávněný přístup | Chybějící nebo neplatné autentizační údaje. Zkontrolujte svůj API klíč nebo JWT token. |
| 402 | Vyžadována platba | Platba za vaše předplatné selhala. Aktualizujte platební údaje ve svém účtu. |
| 403 | Zakázáno | Jste přihlášeni, ale nemáte oprávnění k tomuto zdroji. Váš plán tuto funkci nezahrnuje. |
| 404 | Nenalezeno | Zdroj neexistuje. Zkontrolujte URL endpointu a parametry. |
| 429 | Příliš mnoho požadavků | Překročen limit rychlosti. Počkejte před opakováním. Zkontrolujte hlavičku Retry-After. |
| 422 | Neprocesovatelná entita | Validace selhala. Parametry požadavku jsou neplatné nebo chybí povinná pole. |
Příklady chyb autentizace
Chybějící API klíč (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_MISSING_KEY",
"message": "Nebyly poskytnuty autentizační údaje.",
"resolution": "Zahrňte svůj API klíč do hlavičky Authorization: Authorization: Bearer sk_live_..."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Neplatný API klíč (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_INVALID_KEY",
"message": "Neplatný nebo expirovaný API klíč.",
"resolution": "Vygenerujte nový API klíč z vaší konzole na https://smartmoneyapi.com/console"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Omezení rychlosti (429)
Když překročíte svou kvótu API, server vrátí 429 Příliš mnoho požadavků. Zkontrolujte hlavičky odpovědi pro informace o limitu rychlosti:
HTTP hlavičky
X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600
Odpověď na překročení limitu rychlosti
JSON
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Denní limit požadavků API (10) byl překročen.",
"resolution": "Upgradujte na plán Trader (29 $/měsíc, 400 požadavků/den) nebo Pro (79 $/měsíc, 4 000 požadavků/den).",
"reset_at": "2026-03-22T09:00:00Z"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Chyby validace (422)
Chyby validace nastávají, když jsou parametry vašeho požadavku neplatné nebo chybí povinná pole.
JSON
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validace požadavku selhala.",
"details": [
{
"field": "symbol",
"error": "Neplatný obchodní pár. Očekávaný formát: BTCUSDT"
},
{
"field": "min_position_size",
"error": "Musí být kladné číslo"
}
],
"resolution": "Opravte chyby validace a zkuste to znovu."
},
"timestamp": "2026-03-21T14:35:22Z"
}
5xx Chyby serveru
Chyby serveru indikují problém na naší straně. Jsou dočasné a obvykle se rychle vyřeší. Implementujte logiku opakování s exponenciálním backoffem.
| Kód | Stav | Akce |
|---|---|---|
| 500 | Interní chyba | Neočekávaná chyba serveru. Opakujte s exponenciálním backoffem. |
| 502 | Špatná brána | Dočasné přerušení služby. Opakujte po několika sekundách. |
| 503 | Služba nedostupná | Údržba nebo dočasný výpadek. Zkontrolujte stavovou stránku. Opakujte po intervalu Retry-After. |
| 504 | Časový limit brány | Požadavek trval příliš dlouho. Server jej možná již zpracoval. Zkontrolujte idempotenci. |
Příklad chyby serveru (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Služba je dočasně nedostupná z důvodu údržby.",
"resolution": "Zkuste to znovu po 5 minutách. Sledujte stav na https://status.smartmoneyapi.com"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Průvodce řešením problémů
401 Neoprávněno – Neplatný API klíč
Problém: Dostáváte chyby 401 i s API klíčem.
Řešení:
- Ověřte, že API klíč je zahrnut v hlavičce Authorization s předponou "Bearer"
- Zkontrolujte, že váš API klíč neexpiroval nebo nebyl zrušen
- Ujistěte se, že používáte správný klíč (produkční, stagingový nebo vývojový)
- Vygenerujte nový API klíč z vaší konzole, pokud je současný ztracen
403 Zakázáno – Funkce není k dispozici
Problém: Dostáváte chyby 403 na určitých endpointech.
Řešení:
- Zkontrolujte svou úroveň API. Některé endpointy vyžadují plány Trader nebo Pro
- Upgradujte svůj plán na /pricing.html pro přístup k prémiovým funkcím
- Ověřte, že API klíč má povolené požadované rozsahy
- Kontaktujte podporu, pokud si myslíte, že byste měli mít přístup
429 Příliš mnoho požadavků – Omezení rychlosti
Problém: Dostáváte chyby 429 a jste omezeni rychlostí.
Řešení:
- Implementujte logiku opakování s exponenciálním backoffem (počkejte 1s, 2s, 4s atd.)
- Ukládejte odpovědi do mezipaměti, abyste se vyhnuli redundantním voláním API
- Použijte WebSocket pro data v reálném čase místo dotazování REST endpointů
- Upgradujte svůj plán pro vyšší kvóty (Trader 1,000/den, Pro 5 000/den)
- Sdružte více dotazů do jednoho požadavku, kde je to možné
400 Chybný požadavek – Neplatné parametry
Problém: Dostáváte chyby 400 s chybně vytvořenými požadavky.
Řešení:
- Zkontrolujte dokumentaci API pro povinné a volitelné parametry
- Ověřte typy parametrů (řetězce vs čísla, pole vs objekty)
- Ujistěte se, že JSON je platný a správně formátovaný
- Používejte správné URL endpointů s příslušnými parametry cesty
- Zkontrolujte překlepy v názvech parametrů dotazu
5xx Chyby serveru - Dočasné výpadky
Problém: Zobrazují se chyby 500, 502, 503 nebo 504.
Řešení:
- Zkontrolujte stav služby na https://status.smartmoneyapi.com
- Implementujte automatické opakování s exponenciálním backoffem (max. 5-10 pokusů)
- Před opakováním u chyb 503 počkejte 30-60 sekund
- Použijte hlavičku Retry-After k určení časování opakování
- Přihlaste se k odběru stránky stavu pro oznámení o incidentech
Formát chybové odpovědi
Všechny chybové odpovědi mají konzistentní formát:
JSON
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Lidsky čitelná chybová zpráva",
"details": {...},
"resolution": "Kroky k řešení problému"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Potřebujete další pomoc?
Projděte si naši dokumentaci API nebo kontaktujte podporu s vaším chybovým kódem a detaily žádosti.
Referenční příručka API