Subúčty (partneři)
Sandbox
Testovací partner na testovacím prostředí Coinera. Pokyny se neposílají na burzu, ale procházejí stejným vypořádáním jako ostré.
Sandbox není další prostředí.
Je to testovací partnerský účet na testovacím prostředí (preview), který Coinero založí na vaši žádost. V ostrém provozu sandbox partnera založit nelze. Používáte tentýž kód, tytéž endpointy a partnerský klíč
pk_prev_; jen se pokyny neposílají na burzu.Co sandbox dělá
- Pokyn subúčtu sandbox partnera se na burzu nikdy nepošle. Coinero ho naplní za cenu páru s rozptylem do ±0,1 % a pošle toutéž cestou vypořádání jako skutečný pokyn: poplatek partnera, dokončení pokynu, stavy a webhooky jsou stejné.
- Po naplnění nákupu vznikne simulovaná příchozí platba s variabilním symbolem pokynu na částku, kterou dlužíte, a pokyn se vypořádá (
partner.settledAt). Výplata při prodeji se zapíše jako odeslaná bez bankovního příkazu. Automatická platba funguje v režimu vypořádání po pokynu; v režimu denního netto se pokyn vypořádá výpisem a jeho platbu zadá Coinero na vaši žádost. - Simulované pokyny nehýbou skutečnou burzou ani účetními účty Coinera mimo vyhrazené testovací účty a nepočítají se do jeho kontrol proti burze ani do statistik. Denní report a jeho kontrola sandbox partnera zahrnují.
- Chování se v každém kroku znovu ověřuje podle prostředí: kdyby se příznak sandboxu dostal do ostrého provozu, partner by se choval jako běžný.
Testovací scénáře
Hlavička X-COINERO-TEST-SCENARIO na zadání nebo potvrzení pokynu vybere scénář. Hodnota nerozlišuje velikost písmen. Hlavička se nepodepisuje: podpis kryje timestamp, metodu, cestu a tělo, ne hlavičky.
| Hodnota | Co se stane |
|---|---|
reject-market | Pokyn se odmítne tak, jako by ho odmítla burza. Pokyn je ve stavu rejected a financování se vrátí na master účet. |
partial-fill | Naplní se polovina (u nákupu polovina rozpočtu) a zbytek se zruší. Pokyn je ve stavu partiallyFilled, nespotřebovaný zbytek se vrátí a platba je nižší. |
delayed-fill | Pokyn se naplní 30 sekund po zadání, ne hned. |
timeout | Pokyn se zpracuje normálně, ale odpověď API se zdrží o lhůtu blokace vašeho partnerského účtu plus 5 sekund, nejvýš 220 sekund. U nákupu s potvrzením tak odpověď nedostanete včas, nepotvrdíte ho a pokyn skončí jako cancelled s blockTimeout. U potvrzení se pokyn provede a výsledek zjistíte dotazem. Slouží k vyzkoušení zotavení ze ztracené odpovědi. |
missing-payment | Pokyn se naplní, ale simulovaná platba za něj nevznikne, takže v denním reportu chybí v platbách. Slouží k vyzkoušení denní kontroly. |
- Scénář zadaný při zadání se uloží na pokyn partnera. Hlavička u potvrzení ho nahradí. U pokynu bez potvrzování (prodej, nákup bez vyžadovaného potvrzení) platí od zadání.
- Bez hlavičky se pokyn naplní celý a hned.
- Neznámá hodnota vrací u sandbox partnera HTTP 400
UNKNOWN_TEST_SCENARIO. U partnera, který sandbox není, se hlavička ignoruje. - Opakování se stejným
clientOrderIda opakované potvrzení odpoví hned, i po scénářitimeout.
Reset a čeho se sandbox netýká
- Reset subúčtu provádí Coinero na vaši žádost. Zruší nákupy čekající na potvrzení (důvod
blockTimeout) a volné zůstatky subúčtu vynuluje. Pokud má subúčet financovaný pokyn, pokyn v provádění nebo nevypořádaný obchod, reset se odmítne; zopakovat ho lze později. - Bezpečnost a oprávnění jsou stejné jako v ostrém provozu: podpis, seznam IP adres a limity klíče platí. Pro sandbox platí stejné limity jako pro ostrý klíč partnera.
- Burza v sandboxu chybí: pokyn se naplní podle simulace, takže sandbox neukáže chování skutečné burzy (skluz, odmítnutí burzou) kromě toho, co vyvolá scénář
reject-market. Na to myslete při přechodu na ostrý provoz.
Chyby
| Kód | Stav | Kdy |
|---|---|---|
UNKNOWN_TEST_SCENARIO | 400 | Hlavička X-COINERO-TEST-SCENARIO sandboxu nese hodnotu, kterou sandbox nezná. |