Partner API

Partner pristupuje k API rozhraniu s použitím svojho špecifického partnerského API tokenu v spojení so špecifickým API tokenom e-shopu, ktorý mu poskytol zákazník (oba tokeny sú nutné). Partnerský API token si partner vygeneruje na základe názvu webu, tzv. tajného kľúča a svojho identifikátora partnera. Tajný kľúč a identifikátor partnera poskytneme po podpise partnerskej zmluvy.

Partnerský token sa generuje pomocou hashovacej funkcie sha1, kde vstupným parametrom je textový reťazec zložený z klientskeho účtu, tajného kľúča partnera a identifikátora partnera.

príklad:

klientsky účet = '[zakaznik].flox.cz';
tajný kľúč partnera = '[tajny kluc partnera]';
identifikátor partnera = '[partner]';

(namísto [hodnota] zadejte údaje poskytnuté ByznysWebem)

partner token = sha1(klientsky účet+tajný kľúč partnera+identifikátor partnera);

partner token = sha1('[zakaznik].flox.sk[tajny kluc partnera][partner]');

príklad HTTP požiadavky pre výpis zoznamu objednávok

POST /api/graphql HTTP/1.1

Host: domena.flox.sk

BW-Partner-Key: Partner f12a1884b66e2c09b0775c6b059cead5d65d4d70

BW-API-Key: Token IjwPj8k5S0IFxhQoAzwzCmQ0IJvgKsB7

Content-Type: application/json

Content-Length: 335

{"query":"{
  getOrderList(
    params: {
       limit: 10
       order_by: last_change
    }
filter: {
   order_num: \"2212\"
} )
{
    data {
      id
        order_num
           invoice_address {
                ... _Address
           }
        }
      }
   }"
}

V súčasnosti neaplikujeme žiadne limity pre partnerské volania API. Avšak, v prípade výskytu nadmerného zaťaženia našich serverov, si vyhradzujeme právo implementovať primerané limity týkajúce sa využívania API. V budúcnosti môže byť nadlimitné využitie API spoplatnené Cenou podľa stanoveného cenníka, ktorý bude zverejnený v aktualizovanej Technickej dokumentácii. O akýchkoľvek zmenách, vrátane zavedenia alebo úpravy týchto limitov, budeme našich partnerov informovať vopred.

V Trenčíne 1.3.2023