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 názvu domény webu, tajného kľúča partnera a identifikátora partnera.

príklad:

názov webu = 'domena.flox.cz';
tajný kľúč partnera = 'TajNyKlicPartnera999';
identifikátor partnera = 'Partner';

partner token = sha1(názov webu+tajný kľúč partnera+identifikátor partnera);

partner token = sha1('domena.flox.skTajNyKlicPartnera999Partner');

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