Partner API

Partner přistupuje k API rozhraní s použitím svého specifického partnerského API tokenu ve spojení se specifickým API tokenem e-shopu, který mu poskytl zákazník (oba tokeny jsou nutné). Partnerský API token si partner vygeneruje na základě názvu webu, tzv. tajného klíče a svého identifikátora partnera. Tajný klíč a identifikátor partnera poskytneme po podpisu partnerské smlouvy.

Partnerský token se generuje pomocí hashovací funkce sha1, kde vstupním parametrem je textový řetězec složený z klientského účtu, tajného klíče partnera a identifikátoru partnera.

příklad:

klientský účet = '[zakaznik].flox.cz';
tajný klíč partnera = '[tajny klic partnera]';
identifikátor partnera = '[partner]';

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

partner token = sha1(klientský účet+tajný klíč partnera+identifikátor partnera);

partner token = sha1('[zakaznik].flox.cz[tajny klic partnera][partner]');

příklad HTTP požadavku pro výpis seznamu objednávek

POST /api/graphql HTTP/1.1

Host: domena.flox.cz

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 současnosti neaplikujeme žádné limity pro partnerská volání API. Nicméně, v případě výskytu nadměrného zatížení našich serverů, si vyhrazujeme právo implementovat přiměřené limity týkající se využívání API. V budoucnu může být nadlimitní využití API zpoplatněno Cenou dle stanoveného ceníku, který bude zveřejněn v aktualizované Technické dokumentaci. O jakýchkoli změnách, včetně zavedení nebo úpravy těchto limitů, budeme naše partnery informovat předem.

V Praze 1.3.2023