Jak aplikace pracuje s URL – popis parametrů

1. Odkud aplikace bere informace o produktu. Při otevření čte adresu aplikace a adresu stránky e-shopu, ze které klient přišel (stránka, do které je aplikace vložená, nebo odkazující stránka). V tomto pořadí: parametry v adrese aplikace → ?zdroj= → stránka e-shopu.

Parametr v adrese aplikace	Co dělá	Příklad
zdroj	Adresa produktu e-shopu. Aplikace se chová, jako by klient přišel z této stránky (jazyk, formát, barva desky, notes/diář, návrat {zdroj}). Hlavně pro testování.	?zdroj=https://www.aaapapir.cz/…_d114121.html
lang	Vynutí jazyk klienta: cs, sk, pl, de, en. Bez něj se jazyk určí podle domény e-shopu (.cz, .sk, .pl, .de/.at, .com/.uk), jinak čeština.	?lang=pl
format	Vynutí formát (rozměr tiskového PDF) – jeden z hledaných textů pravidla v tabulce „Formáty podle URL“ (celý text mezi čárkami). Bez něj se formát hledá v adrese produktu.	?format=diar-gep-s-propiskou-denni-a5-
deska	Vynutí barvu desky podle názvu z tabulky barev (bez diakritiky, pomlčky místo mezer). Bez něj se barva pozná z názvu produktu za ročníkem, např. …-2027-cesky-tyrkysova-….	?deska=bordo
rok	Vynutí letopočet na deskách (2020–2099). Bez něj se použije rok z adresy produktu (např. …-a4-2026-bezova_d107853.html → 2026), pak letopočet z administrace, nakonec podle šablony. Klient může rok vždy změnit ve vlastnostech letopočtu.	?rok=2028
token	Kód objednávky předaný e-shopem, tvar gen- + číslo (max. 20 číslic) – stejně jako u konfigurátoru samolepek. Bez něj si aplikace vytvoří gen- + aktuální čas v ms. Jiný tvar se ignoruje.	?token=gen-1792400000001

Notes (bez letopočtu) se pozná podle adresy produktu – obsahuje notes-, zapisnik- nebo notatnik-.

2. Co aplikace pošle zpět po „Přidat do košíku“. Po úspěšném odeslání návrhu přesměruje klienta na návratovou URL daného jazyka (sekce „Návratová URL po přidání do košíku“). Prázdná = klient zůstane v aplikaci. K adrese vždy připojí:

Parametr návratové URL	Obsah
order_token	Kód objednávky (gen-…) – stejný je v názvech souborů, ve složce na Google Disku i v čárovém kódu.
quantity	Počet návrhů, které aplikace vytvořila – u diáře/notesu vždy 1 (jeden návrh desek).
quantitysheets	Počet kopií, které se pošlou do e-shopu = objednané kusy (po úpravě na minimum a krok). Do košíku se vloží tento počet.
preview_url	Veřejný odkaz na souhrnný náhled pro klienta (JPG: čelní pohled, rozložené desky, kód objednávky s čárovým kódem, produkt, deska, počet kusů) na Google Disku. Otevře ho kdokoli s odkazem. Jen když je odesílání na Disk nastavené.
barcode	Hodnota čárového kódu = order_token (Code 128).
barcode_url	Odkaz na obrázek čárového kódu (SVG) pro objednávku nebo výrobu.

Zástupné znaky v návratové URL: {zdroj} = stránka produktu, ze které klient přišel (návrat jako u samolepek); {kod} = kód objednávky; {ks} = počet kusů (stejně jako quantitysheets); {produkt} = ID produktu. Příklad: {zdroj} nebo https://www.aaapapir.cz/nakupni-kosik.html.

3. Zpráva pro e-shop. Když je aplikace vložená do stránky e-shopu (iframe), pošle navíc zprávu postMessage typu diar:add-to-cart s poli code, order_token, quantity (počet návrhů = 1), quantitysheets (počet kusů), barcode, barcode_url, preview_url, product, board, folder_id, folder_url.

4. Podklady objednávky. Do složky datum čas gen-… N ks se uloží: tiskové PDF, čelní a rozložený náhled, návrh (JSON), čárový kód (SVG) a info.json s údaji (kód, čárový kód, počet kusů, deska, jazyk, formát, rozměr, spadávka, adresa produktu).

Vyzkoušet adresu produktu (otevře aplikaci tak, jako by klient přišel z této stránky e-shopu – jazyk, formát, barva desky i návrat {zdroj}; stejně funguje parametr ?zdroj=<adresa>)

Horní lišta (červená lišta nad aplikací – pro každou jazykovou verzi vlastní logo a texty; jazyk se určí podle e-shopu, ze kterého klient přišel)

Rozměr tiskového PDF

Šířka rozložených desek – osa X (mm) Výška desek – osa Y (mm) Spadávka (mm) Rozlišení exportu (DPI) 200300400600

Formáty podle URL adresy (jiný rozměr tiskového PDF podle adresy, ze které klient přijde)

Barvy desek (předvolby barvy podkladu v editoru – odstíny diářů GEP bez potisku z e-shopu; struktura se projeví jen v náhledech, ne v tiskovém PDF)

Odesílání návrhů (tlačítko „Přidat do košíku“)

Výchozí ID složky na Google Disku (pro formát bez vlastní složky)

Po kliknutí na „Přidat do košíku“ se do této složky uloží podsložka s kódem návrhu: tiskové PDF a podsložka „nahled“ s náhledem pro klienta (ostatní soubory zůstávají v záloze na serveru). ID najdete v adrese složky za /folders/; můžete vložit i celý odkaz.

Klíč servisního účtu Google (.json)

Odesílání používá servisní účet Google: v Google Cloud vytvořte servisní účet se zapnutým Google Drive API, stáhněte jeho klíč (JSON) a nahrajte ho sem. Cílová složka musí být na sdíleném disku (Shared Drive) a e-mail servisního účtu do ní přidejte jako Editora. Kopie každého odeslaného návrhu zůstává i na serveru aplikace.

Tisk a barvy

ICC profil CMYK Nahrát ICC profil (.icc) Převodní záměr Relativní kolorimetrický + BPC Perceptuální Sytost Absolutní kolorimetrický Ořezová kontura v PDF (přímá barva) Název přímé barvy kontury Bílý podtisk na barevných deskách Ano – bílou nastavuje obsluha na stroji, barvy jsou krycí Ne – tisk na desku je průsvitný

PDF zůstává jen CMYK, bílá se do něj nevkládá. Volba řídí jen náhledy a zadání pro AI. Čistě bílá místa zůstanou bez barvy i bez bílé.

Produkt a náhledy

Název produktu Zóna obšití od okraje (mm) Obšití má barvu potisku (tiskne se po ušití) Barva nitě, když se obšití nepotiskuje Barva podšívky a hran (náhled) Propiska v náhledech Ochranná zóna kolem výřezu a pera (mm)

Blok stránek ve 3D náhledu (netýká se tiskového PDF, mění se automaticky s rozměrem desek)

Šířka bloku stránek (mm) Výška bloku stránek (mm)

AI a zabezpečení

Letopočet (rok, který se vloží na desky; prázdné = automaticky: rok v adrese produktu, jinak podle šablony – nyní 27B = 2027. Parametr ?rok= v adrese má přednost)

Letopočet na deskách

Košík – počet kusů (klient zadává počet u tlačítka Přidat do košíku; počet se zaokrouhlí nahoru na minimum a násobky kroku)

Minimální počet kusů Krok (objednává se po … ks)

Návratová URL po přidání do košíku (kam se klient přesměruje po úspěšném přidání do košíku, např. košík e-shopu; prázdné = zůstane v aplikaci jako dosud. Aplikace k adrese vždy připojí order_token, quantity (= počet návrhů, vždy 1), quantitysheets (= počet kusů), preview_url, barcode a barcode_url jako konfigurátor samolepek. V adrese lze použít {zdroj} = stránka produktu, ze které klient přišel, {kod}, {ks}, {produkt})

Služby v košíku a řada Design (diáře Design jsou potištěné diáře GEP: klient navrhuje na nepotištěnou desku stejné barvy, do košíku jde diář Design, ze kterého přišel, a služba Design s vlastní cenou. Řada se pozná z adresy produktu Design nebo z parametru ?rada=design. Návratová URL řady Design = stránka služby Design; prázdné = jako u GEP)

ID služby GEP v i6 ID služby Design v i6

Omezení AI generování (počet vygenerovaných motivů za den; 0 = bez omezení; počítá se od půlnoci, administrátor se nepočítá)

Denní limit na jednu IP adresu Denní limit celkem (všichni klienti)

AI model GPT Image 2.5 Flare (kvalita) Nano Banana 2 (rychlý) Nano Banana Pro Seedream 5 (levný) Kurz USD/CZK denní kurz ČNB (automaticky)pevný kurz Pevný / záložní kurz (Kč za 1 USD) Text promptu (USD za 1 M tokenů) Příplatek za předlohu (USD za obrázek)