Volanie API
Verejný endpoint
API počúva na adrese https://vasa-stranka.flox.sk/api/graphql. Upozorňujeme, že každá žiadosť musí byť odoslaná s HTTP hlavičkou Content-Type: application/json.
Žiadost o autorizáciu
Všetky žiadosti musia byť autorizované poskytnutím tokenu v HTTP hlavičke. Existujú dva typy tokenov:
- povolenie webovej stránky – v administrácii webu môžete vytvoriť niekoľko rôznych tokenov s rôznymi úrovňami autorizácie prístupu. Ku každej žiadosti poskytnite hlavičku HTTP s názvom „BW-API-Key“ s hodnotou „Token <32-znakov-dlhý-token>".
BW-API-Key: Token sFO999K9YlbLUBLZA8twFsWui5yAU7lT
Poznámka:
hodnota hlavičky musí pozostávať zo statického slova „Token", za ktorým nasleduje medzera a token s dĺžkou 32 znakov, ktorý rozlišuje veľké a malé písmená.
- rozšírenie aplikácie – tento token poskytuje integračný partner / cloud BizWebs a autorizuje použitie neverejných funkcií API pre konkrétne rozšírenie
Každá žiadosť musí obsahovať autorizačný token webovej stránky, inak sa vráti chybový kód HTTP 401. Žiadosti špecifické pre rozšírenie musia obsahovať autorizačný token webovej stránky, aj token rozšírenia aplikácie. Ak je token rozšírenia neplatný, alebo chýba, vráti sa kód chyby HTTP 412.
Schéma
Prečítajte si dokumentáciu alebo vizualizáciu BiznisWeb API .
Ak používate „..._<entity name>" fragment, nemusíte špecifikovať zoznam požadovaných polí pre konkrétnu entitu na získanie predvolenej sady polí.
Príklad:
getOrder (order_num: „2101006") { ..._Order }
Odpoveď
{ order_num: „2101006", sum: „150 €" }