Autentifikácia
Vytvorenie API prepojenia a autentifikácia hlavičkou api_key.
Doklado Public API overuje požiadavky pomocou API kľúča. Kľúč posielajte v HTTP hlavičke api_key.
Vytvorenie API kľúča
- Vo webovej aplikácii otvorte Prehľad účtu → API prepojenia.
- Kliknite na + Nové API prepojenie.
- Zadajte názov prepojenia a nastavte denný alebo mesačný limit, prípadne neobmedzený limit využitia.
- Kliknite na Vygenerovať nové prepojenie a získaný kľúč uložte do konfigurácie svojej integrácie.
Podrobný postup a správu limitov nájdete v návode API prepojenia.
Hlavičky požiadavky
api_key: VAS_API_KLUC
Content-Type: application/json
Accept: application/json
Hodnotou api_key je samotný kľúč, bez predpony Bearer. Hlavička Authorization nie je autentifikačnou hlavičkou definovanou v tejto OpenAPI špecifikácii.
Kľúč uchovávajte na serveri, napríklad v premennej prostredia DOKLADO_API_KEY. Nevkladajte ho do verejného repozitára, klientského JavaScriptu ani URL a nezapisujte ho do logov.
Výber organizácie
Pri načítaní dokladov cez POST /v2/documents identifikuje pole data.organizationId firmu jej IČO. Nie každý endpoint používa rovnaký spôsob výberu organizácie; riaďte sa jeho schémou.
Endpoint POST /v1/organization/bank-transactions vyžaduje kľúč viazaný na konkrétnu organizáciu. Organizácia sa určí z kľúča a neposiela sa v tele požiadavky. Postup vydania tohto typu kľúča špecifikácia neuvádza; v prípade potreby kontaktujte podporu Doklado.
Overenie prístupu
Spustite prvé volanie API. Ak dostanete 403 alebo aplikačný kód APP_UNAUTHENTICATED, skontrolujte hodnotu kľúča, názov hlavičky a prístup k požadovanej organizácii. Po vyčerpaní nastaveného limitu môže API vrátiť 429; podrobnosti sú v návode API prepojenia.
Zdroj technických parametrov: OpenAPI špecifikácia Doklado.