Klíč partnera
Partnerský klíč patří partnerovi, ne klientovi. Vydává ho Coinero a slouží k práci se subúčty vašich klientů.
Dva druhy klíčů
| Vlastnost | Klientský klíč | Partnerský klíč |
|---|---|---|
| Prefix | ck_live_, ck_prev_, ck_dev_ | pk_live_, pk_prev_, pk_dev_ |
| Kdo ho vydává | Klient v aplikaci Coinero | Coinero na žádost partnera |
| Oprávnění | market, account, trade | market, subaccounts |
| Seznam IP adres | Volitelný | Povinný (alespoň jedna adresa nebo rozsah) |
| S čím pracuje | S účtem klienta | Se subúčty klientů partnera pod /v1/subaccounts, s reporty a webhooky |
| WebSocket | Ano | Ne, handshake vrací HTTP 403 FORBIDDEN |
Do hlavičky X-COINERO-APIKEY patří celý klíč. Podpis požadavků je stejný jako u klientského klíče, viz Podpis požadavků: HMAC-SHA256 se secretem klíče nad timestamp + METHOD + path + body, okno ±30 sekund a stejné chyby SIGNATURE_REQUIRED, INVALID_SIGNATURE a TIMESTAMP_OUT_OF_WINDOW.
Oprávnění
| Oprávnění | Co dovoluje | Podpis |
|---|---|---|
market | Tržní data a stav API bez prefixu: GET /v1/ticker, GET /v1/markets a další, viz Tržní data. | Ne |
subaccounts | Všechno pod /v1/subaccounts, /v1/reports a /v1/webhooks. | Ano, vždy |
Partnerský klíč nikdy nemá oprávnění account ani trade: endpointy klientského účtu a pokynů (/v1/account/…, /v1/orders…) vrací HTTP 403 INSUFFICIENT_PERMISSION. Opačně klientský klíč nemá subaccounts a partnerské endpointy odmítne stejným kódem. Zůstatky a pokyny klienta čtete a zadáváte vždy pod prefixem subúčtu.
Vydání
- Klíč vydává Coinero na vaši žádost. API klíče nevydává ani nemění.
- Klíč a secret se zobrazí jen jednou, hned po vydání. Secret slouží k podpisu požadavků, uložte ho na serveru.
- Klíč nejde vydat bez seznamu IP adres. Zadává se nejvýš 10 adres nebo rozsahů v zápisu CIDR (IPv4 i IPv6) stejně jako u klientského klíče, viz Oprávnění a životnost klíče. Požadavek z adresy mimo seznam dostane HTTP 403
IP_NOT_ALLOWED. - Platnost může být omezená datem expirace. Po okamžiku expirace klíč přestane platit a API vrací HTTP 401
INVALID_API_KEY. E-mailovou připomínku expirace Coinero partnerovi neposílá. Datum expirace si poznamenejte při vydání klíče.
Klíč ověřený, zápisy zastavené.
PARTNER_SUSPENDED; čtení a odeslání výsledku denní kontroly zůstávají. Klíč partnera s ukončenou spoluprací se neověří (401).Vzájemné TLS
Vzájemné TLS (klientský certifikát partnera) zapíná Coinero na partnerských cestách v produkci na vaši žádost. Klíč, podpis požadavků a seznam povolených IP adres platí vždy, mTLS je doplněk po dohodě.
Rotace
Rotaci provádí Coinero na vaši žádost. Vydá nový klíč se stejným názvem, seznamem adres a expirací a starý klíč buď zruší hned, nebo ho nechá platit dalších 24 hodin, abyste stihli přepnout své systémy. Odklad platnost nikdy neprodlouží, jen ji zkrátí, takže starému klíči s dřívější expirací platí ta dřívější. Klíč, který už byl rotovaný, se znovu rotovat nedá; další rotace vychází z nového klíče.
Zrušení
Klíč ruší Coinero, například na vaši žádost. Zrušení je nevratné a klíč přestane platit okamžitě, výjimečně nejpozději do minuty. Zrušený klíč vrací HTTP 401 INVALID_API_KEY.
Limity
Partnerský klíč má vlastní počítadla: 600 požadavků a 300 pokynů za minutu. Podrobnosti jsou na stránce Limity požadavků.
Chyby
| Kód | Stav | Kdy |
|---|---|---|
INVALID_API_KEY | 401 | Zadaný API klíč nelze použít. |
SIGNATURE_REQUIRED | 401 | Požadavek na endpoint s podpisem nemá hlavičky podpisu. |
INVALID_SIGNATURE | 401 | Podpis požadavku nesouhlasí s tím, co server vypočítal. |
TIMESTAMP_OUT_OF_WINDOW | 401 | Časová značka v hlavičce X-COINERO-TIMESTAMP je příliš daleko od času serveru. |
IP_NOT_ALLOWED | 403 | Požadavek přišel z adresy, která není na seznamu povolených adres klíče. |
INSUFFICIENT_PERMISSION | 403 | Klíč nemá oprávnění, které endpoint vyžaduje. |
PARTNER_SUSPENDED | 409 | Partnerský účet je pozastavený nebo ukončený. |