API StocksTrader umožňuje interakci s obchodní platformou, ale pokud požadavky nejsou správně vytvořeny, může dojít k chybám. Tento průvodce vysvětluje nejčastější chybové kódy — 400 Bad Request a 401 Unauthorized — a nabízí kroky, jak je vyřešit.

Díky tomuto průvodci snadno identifikujete a vyřešíte běžné chyby API StocksTrader.

Běžné chybové kódy

1. 400 – Špatný požadavek (Bad Request)

Co to znamená: Požadavek obsahuje chybu – například nesprávnou URL adresu, chybějící nebo neplatné parametry, nebo nesprávný formát dat.

Příklady:

• Použití /api/v1/logout/account místo správného /api/v1/logout
• Chybějící povinná pole jako ticker, volume, side nebo type v POST požadavku na /api/v1/accounts/{account_id}/orders
• Neplatný account_id nebo ticker v požadavcích jako /api/v1/accounts/{account_id}/instruments/{ticker}

Jak opravit:

• Zkontrolujte URL adresu: Ujistěte se, že odpovídá dokumentaci API.
• Zkontrolujte parametry: Všechny povinné parametry musí být uvedeny a platné.
• Zkontrolujte formát dat: Tělo požadavku musí odpovídat očekávanému formátu.
• Zkontrolujte odpověď: Pole msg v chybové odpovědi může napovědět, co je špatně.

2. 401 – Neautorizovaný přístup (Unauthorized)

Co to znamená: V požadavku chybí autorizační token nebo je token neplatný.

Příklady:

• Přístup na /api/v1/accounts bez tokenu typu Bearer
• Použití expirovaného nebo neplatného tokenu

Jak opravit:

• Přidejte token: Do hlavičky požadavku přidejte pole Authorization.
• Zkontrolujte token: Pokud je token neplatný nebo vypršel, vygenerujte nový ve webovém terminálu StocksTrader.
• Zkontrolujte oprávnění: Ujistěte se, že token patří účtu, který má přístup k požadovanému zdroji.

Obecná doporučení

• Konzultujte dokumentaci: Vždy se řiďte oficiální dokumentací API – správné endpointy, parametry a datové formáty.
• Logujte požadavky a odpovědi: Ukládejte si celé požadavky a odpovědi (včetně pole msg) pro následnou analýzu.
• Testujte předem: Ověřte požadavky pomocí nástrojů jako Postman před nasazením do produkce.
• Kontaktujte podporu: Pokud problém přetrvává, kontaktujte technickou podporu a uveďte podrobnosti o požadavku (URL, tělo požadavku a odpověď).

Příklad: Oprava chyby 400

Problém: Obdržíte chybu 400 při odeslání POST požadavku na /api/v1/logout/account.

Řešení:

1. Zkontrolujte dokumentaci – správný endpoint je /api/v1/logout.

2. Upravte URL na https://api.stockstrader.com/api/v1/logout.

3. Ujistěte se, že jde o POST požadavek s platnou hlavičkou Authorization.

4. Zkuste požadavek znovu.

Příklad: Oprava chyby 401

Problém: Obdržíte chybu 401 při odeslání GET požadavku na /api/v1/accounts za účelem získání seznamu účtů.

Řešení:

1. Zkontrolujte hlavičky – pole Authorization musí být přítomno.

2. Pokud chybí, přidejte ho. Pokud je token neplatný, vygenerujte nový ve webovém terminálu StocksTrader.

3. Ujistěte se, že token patří účtu, který má přístup k /api/v1/accounts.

4. Zkuste požadavek znovu s platným tokenem.