SorryYako - technicke informace pro vyvojare

K cemu to cele je?

Data ve formatu JSON obsahuji carove kody firem Holdingu Agrofert a firem, ktere pusobi v pribuznych oborech ale nejsou soucasti Holdingu. Data jsou aktualizovana FaceBookovou skupinou SorryYako a jsou vsem vyvojarum k dispozici zdarma a bez omezeni.

Data nejsou koncipovana pro online dotazovani, ale spis pro obcasne kompletni stazeni do aplikace.

 

Rizika

Nelze stoprocentne vyloucit nestabilitu, preruseni provozu nebo uplne zruseni hostingu dat z nepredvidatelnych duvodu.. Aplikace by mely pocitat s docasnou nedostupnosti a v krajnim pripade i presunem dat na jiny server.

 

Muze se stat, ze bude nutne zmenit datovou strukturu. V takovem pripade budou vytvoreny nove endpointy a stara data budou ponechana na puvodnich endpointech, ovsem uz bez dalsich aktualizaci.

 

Endpointy a struktura dat:

 

Čárové kódy EAN-13 Agrofertu
endpoint:
  https://api.npoint.io/787fcb1034ae1267704b
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    nazev [string, povinny] - jmeno firmy
    kod [string, povinny] - carovy kod (resp jeho GCP cast)
    struktura [string] - vlastnicka struktura, zatim nepouzito
    pozn [string] - poznamka k firme, napriklad ze se vlastnicka struktura zmenila

 

Čárové kódy EAN-13 ostatních dodavatelů
endpoint:
  https://api.npoint.io/d9b2e38d54f80a17b3a6
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    nazev [string, povinny] - jmeno firmy
    kod [string, povinny] - carovy kod (resp jeho GCP cast)
    struktura [string] - vlastnicka struktura, zatim nepouzito
    retezec [int] - priznak obchodniho retezce, 1=retezec
    pozn [string] - poznamka k firme

 

Čárové kódy EAN-8 Agrofertu 
endpoint:
  https://api.npoint.io/930f3ecd2c04f04a0b36
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    nazev [string, povinny] - jmeno firmy
    kod [string, povinny] - carovy kod (bez kontrolni cislice)
    struktura [string] - vlastnicka struktura, zatim nepouzito
    pozn [string] - poznamka k firme
    pocet [int] - pokud jde o spojity blok carovych kodu inkrementalne ocislovanych, zde je velikost bloku

 

Čárové kódy EAN-8 ostatních dodavatelů 
endpoint:
  https://api.npoint.io/28601550eca10717067f
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    nazev [string, povinny] - jmeno firmy
    kod [string, povinny] - carovy kod (bez kontrolni cislice)
    struktura [string] - vlastnicka struktura, zatim nepouzito
    pozn [string] - poznamka k firme
    pocet [int] - pokud jde o spojity blok carovych kodu inkrementalne ocislovanych, zde je velikost bloku

 

Čárové kódy privátních značek 
Seznamy výrobků prodávaných pod privátní značkou v jednotlivých řetězcích. Tyto seznamy jsou na SorryYako zatím experimentálně, není jisté že je bude možné dostatečně rychle aktualizovat, aby odpovídaly stavu na prodejnách.
endpointy:
  Albert: https://api.npoint.io/b73de7e440f376f0a5e1
  Billa: https://api.npoint.io/c01ed3a3f4a2eb957516
  Globus: https://api.npoint.io/8151650758dcbc1d08c0
  Kaufland: https://api.npoint.io/9951aa444f1e8bc75df4
  Lidl: https://api.npoint.io/779941dbe972da8c8d8f
  Norma: https://api.npoint.io/91f12e3d2005b55a2b74
  Penny: https://api.npoint.io/cef263d4cc5aae2cbb9b
  Tesco: https://api.npoint.io/1f5cfddc28407c80ed3e
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    kod [string, povinny] - carovy kod (bez kontrolni cislice)

    vyrobce [string, povinny] - jmeno firmy

    produkt [string, povinny] - nazev vyrobku

    pozn [string] - poznamka k firme
    holding [int] - 1 = firma z holdingu Agrofert; vynechany atribut nebo jina hodnota znamena, ze pod holding nespada

 

Váhové kódy
endpoint:
  https://api.npoint.io/c8daae65c7e9eb327465
struktura:
  info [string, povinny] - strucny popis dat
  firmy [array, povinny] - seznam firem
    kod [string, povinny] - carovy kod (pouze prvniích 6 znaku, 7. je kontrolni soucet, zbytek je hmotnost)
    vyrobce [string, povinny] - jmeno firmy

    produkt [string, povinny] - nazev vyrobku, prvni tri znaky identifikuji retezec. Napr. "{A}" = Albert

    holding [int] - 1 = firma z holdingu Agrofert; vynechany atribut nebo jina hodnota znamena, ze pod holding nespada

 

Verze dat 
endpoint:
  https://api.npoint.io/5bd8a928a1ab49f5bf54
struktura:
  info [string, povinny] - strucny popis dat
  datum [string, povinny] - datum posledni aktualizace (libovolneho z datovych souboru)
  zprava [string] - zprava, kterou je mozne zobrazit uzivateli po aktualizaci dat. Napriklad informace, ze v budoucnu dojde ke zmene umisteni nebo struktury dat a bude nutne udelat upgrade aplikace. Predpokladane vyuziti atributu - jen zcela vyjimecne.