Príručka

Úvod

Ľavý postranný panel obsahuje odkazy na príslušné sekcie:

  • Meno používateľa - odkazy na osobný profil.
  • Nástenka - zobraziť aktuálny stav vo forme grafov a diagramov.
  • Aplikácie - správa aplikácie.
  • Kódy na odomknutie - kódy na odomknutie generované automaticky alebo nahrané vami.
  • Platby - história prichádzajúcich platieb používateľov.
  • Príručka - táto používateľská príručka.

Nástenka

Môžete nastaviť bežné filtre pre všetky widgety na nástenke:

  • Mena - mena, do ktorej budú na nástenke konvertované prichádzajúce a odchádzajúce sumy.
  • Obdobie - časové obdobie, za ktoré sa údaje zobrazujú v grafoch a tabuľkách na nástenke. Určuje interval, za ktorý sa analyzujú a zobrazujú informácie a štatistiky o platbách, aplikáciách a iných parametroch.

Zostatok

Táto časť nástenky zobrazuje kľúčové finančné ukazovatele týkajúce sa výberu. Obsahuje súhrnné informácie o všetkých platbách používateľov, pričom zohľadňuje poplatky strhnuté platobnými systémami a službou PayToUse.

V tomto bloku sa zobrazujú nasledujúce sumy:

  • Hrubá suma: Celkový objem všetkých platieb používateľov za vybrané obdobie pred odpočítaním akýchkoľvek poplatkov.
  • Čistá suma: Celková suma všetkých platieb za vybrané obdobie po odpočítaní poplatkov platobného systému a poplatkov za službu PayToUse.
  • Čakajúce: Čistá suma z platieb, ktoré ešte nie sú k dispozícii na výber. Prostriedky budú k dispozícii na výber 7 dní po uskutočnení platby.
  • Dostupné: Celková čistá suma všetkých platieb, ktoré si už môžete vybrať na svoj účet. Ide o hlavný ukazovateľ odrážajúci váš skutočný zostatok, ktorý je možné vybrať.

Platby so stavom Test sú vylúčené zo všetkých štyroch vyššie uvedených súm, ako aj z widgetu Platby nižšie - nikdy nezahŕňajú skutočné peniaze.

Vybrať prostriedky

Pod ukazovateľom dostupnej sumy sa nachádza tlačidlo „Vybrať“. Slúži na podanie žiadosti o prevod vašich zarobených prostriedkov.

Po kliknutí na toto tlačidlo sa otvorí modálne okno, v ktorom je potrebné zadať platobné údaje pre prevod.

Dôležitá poznámka: Systém automaticky použije na výber celú dostupnú sumu uvedenú v príslušnom poli. Nemôžete zadať ľubovoľnú sumu, ktorá je nižšia ako dostupný zostatok. Celková suma výberu je súčtom všetkých platieb, ktoré majú stav „dostupné na výber“.

V modálnom okne môžete zvoliť sumu a menu pre výber. Dostupné meny závisia od vašich platobných metód.

Poznámka: Ak vybraná mena nie je podporovaná pre zvolený spôsob výberu, žiadosť o výber bude zamietnutá.

Ďalšie informácie o stave a histórii vašich žiadostí o výber nájdete v sekcii Výbery.

Platby

Widget Platby obsahuje tabuľku platieb zoskupených podľa aplikácie za zvolené obdobie.

Stĺpce tabuľky:

  • Aplikácia - aplikácia. V tabuľke sú zobrazené iba aplikácie, pre ktoré boli v zvolenom období uskutočnené platby.
  • Platby - počet platieb.
  • Hrubá suma - celková suma všetkých platieb používateľov za zvolené obdobie pred odpočítaním poplatkov platobných systémov a PayToUse.
  • Čistá suma - celková suma všetkých platieb za zvolené obdobie mínus poplatky platobných systémov a PayToUse.

Graf zobrazuje dynamiku hodnôt Čistá suma a Hrubá suma podľa dní.

Noví používatelia

Graf nových používateľov zobrazuje dve hodnoty v dynamike podľa dní:

  • Noví používatelia - počet nových volaní API. Prístupy k API sú zaznamenané iba v prípade, že sa parameter device - jedinečný identifikátor zariadenia - prenesie pri odosielaní požiadavky na API. Tento parameter musí byť skutočne jedinečný pre zariadenie. (pozri Posielanie požiadavky)
  • Platby - počet platieb za rovnaké obdobie podľa dní.

Konverzia

Metrika konverzie vyjadruje, ako efektívne premieňate Noví používatelia na Platby.

Graf zobrazuje pomer počtu Platby k počtu Noví používatelia, v percentách.

Aplikácie

Pri vstupe do tejto časti sa zobrazí zoznam vašich aplikácií.

Zoznam stĺpcov v tabuľke aplikácií:

  • # - jedinečný identifikátor aplikácie. Používa sa pri overovaní kódu aplikácie alebo zobrazovaní formulára platby.
  • Názov - názov aplikácie. Názov sa zobrazuje len vám v správach a na nástenke. Kliknutím na názov aplikácie sa otvorí stránka úpravy aplikácie.
  • Stav - aktuálny stav aplikácie. Zodpovedá tomu, ako ďaleko postúpil sprievodca nastavením. Môže byť:
    • Vytvorené - aplikácia bola práve vytvorená, krok Aplikácia ešte nie je dokončený.
    • Popis - krok Popis ešte nie je dokončený.
    • Cena - krok Cena ešte nie je dokončený.
    • Test - všetky kroky nastavenia sú dokončené, ale aplikácia ešte nebola spustená. Dá sa použiť na testovacích platieb. Nie je dostupná koncovým používateľom.
    • Spustiť - aplikácia je spustená a prijíma skutočné platby.
  • Vytvorené - dátum vytvorenia aplikácie.
  • Dodatočné ovládacie tlačidlá:
    • Odstrániť - odstrániť aplikáciu zo zoznamu.

Vytváranie alebo úprava aplikácie

Ak chcete prijímať platby, musíte postupne vyplniť všetky potrebné údaje aplikácie a aplikáciu aktivovať.

Tlačidlo na vytvorenie novej aplikácie sa nachádza v záhlaví zoznamu aplikácií.

Aplikácia

Polia dostupné pri vytváraní aplikácie:

  • Názov - názov aplikácie, ktorý vidíte iba vo vašich správach alebo na nástenke. Názov sa zobrazí v hlavičke stránky uloženej aplikácie. Pokiaľ aplikácia nie je uložená, namiesto názvu sa zobrazuje „Nová aplikácia“. Pole je povinné na vyplnenie.
  • Kontaktný e-mail - e-mailová adresa, na ktorú sa budú posielať kópie správ odoslaných používateľom. Táto adresa sa uvádza aj v poli „Reply-To“ a používateľ na ňu odpovedá na prijatý e-mail s kódom. Povinné pole. Predvolene sa vyplní hodnotou z profilu vývojára. Hodnotu je možné zmeniť.
  • Typ aplikácie - typ aplikácie:
    • Jednotlivá - bežná aplikácia s vlastným platobným formulárom a vlastnými kódmi na odomknutie.
    • Skupina s kľúčom len pre jednu aplikáciu - jeden nákup pre viacero aplikácií. Používateľ zaplatí raz v platobnom formulári skupiny a kód je možné aktivovať v ľubovoľnej jednej aplikácii skupiny. Po aktivácii v jednej aplikácii je kód v ostatných nedostupný.
    • Skupina s kľúčom pre všetky aplikácie - jeden nákup pre viacero aplikácií. Používateľ zaplatí raz v platobnom formulári skupiny a dostane jeden kód, ktorý funguje vo všetkých aplikáciách skupiny. V každej aplikácii sa kód aktivuje a priradí k zariadeniu samostatne. Doba platnosti kódu je spoločná: počíta sa od prvej aktivácie v ktorejkoľvek aplikácii skupiny.
  • Zoznam aplikácií skupiny - zobrazuje sa pri skupinových typoch. Vyberte aplikáciu v zozname a kliknite na Pridať. Do skupiny je potrebné pridať aspoň dve aplikácie. V zozname sú dostupné iba vaše samostatné aplikácie, pre ktoré sa generujú kódy na odomknutie. Pre každú aplikáciu skupiny sa vytvorí kópia kódu skupiny a v zozname kódov na odomknutie sa tieto kódy zobrazujú pod kódom skupiny so stavom Neznáme.
  • Povoliť spätnú väzbu počas platby - pridáva pole do platobného formulára, do ktorého môžu používatelia vložiť voľný text. Spätná väzba sa pridá do kópie e-mailu pre vývojára. Spätnú väzbu je možné vidieť aj v podrobnostiach o platbe.

Zmeny sa ukladajú automaticky pri písaní alebo zmene hodnôt - tlačidlo Uložiť nie je. Správa sa zobrazí, len ak sa niečo nepodarilo uložiť. Kedykoľvek sa môžete vrátiť a urobiť zmeny neskôr.

Medzi krokmi prepínajte v hlavičke stránky - pri posúvaní zostáva hore. Ďalší krok je dostupný, keď je aktuálny vyplnený; prechod naň uloží aktuálny krok.

Popis

Vyberte jazyk zo zoznamu a kliknite na Pridať.

Zobrazí sa karta s lokalizovanými textami aplikácie pre vybraný jazyk.

Dostupné jazyky:

  • Nemčina
  • Angličtina
  • Francúzština
  • Španielčina
  • Ruština
  • Čínština (zjednodušená)

Polia v popise sa používajú na zobrazenie informácií v platobnom formulári a v odpovednej správe používateľovi:

  • Lokalizovaný názov - názov aplikácie pre vybraný jazyk. Zobrazuje sa na platobnom formulári a v e-maile s upozornením na platbu. Pri pridaní jazyka sa predvolene vloží názov aplikácie. Pre každý jazyk môžete nastaviť iný názov. Povinné pole.
  • Popis aplikácie - stručný popis aplikácie. Zobrazuje sa na platobnom formulári pod názvom aplikácie. Voliteľné pole. Môžete ho nechať prázdne, ak nechcete zobraziť žiadny popis.
  • Správa o potvrdení nákupu - dodatočné informácie, ktoré sa po úspešnej platbe odošlú používateľovi e-mailom. Text odpovede sa pridá na koniec e-mailu po štandardnej odpovedi.

Na uloženie a prejdenie na ďalšiu stránku musí byť pridaný aspoň jeden jazyk.

Jazyk platobného formulára sa určuje automaticky podľa nastavení prehliadača používateľa. Označte jeden z jazykov prepínačom vedľa jeho karty (popis Použiť predvolené): jeho texty sa zobrazia, ak jazyk používateľa nie je medzi pridanými.

Ak chcete jazyk odstrániť, kliknite na tlačidlo odstránenia na jeho karte a potvrďte odstránenie.

Zmeny sa ukladajú automaticky pri písaní alebo zmene hodnôt - tlačidlo Uložiť nie je. Správa sa zobrazí, len ak sa niečo nepodarilo uložiť. Kedykoľvek sa môžete vrátiť a urobiť zmeny neskôr.

Medzi krokmi prepínajte v hlavičke stránky - pri posúvaní zostáva hore. Ďalší krok je dostupný, keď je aktuálny vyplnený; prechod naň uloží aktuálny krok.

Cena

Stránka obsahuje zoznam cien a polí súvisiacich s platbou:

  • Skúšobná doba - dĺžka skúšobného obdobia.
  • Časová jednotka - časová jednotka skúšobného obdobia. Napríklad, ak zadáte 7 dní, znamená to, že po 7 dňoch od prvého volania API aplikácie vráti odpoveď, že skúšobné obdobie vypršalo. Čas prvého volania zariadenia je uložený.
  • Metóda výpočtu ceny - Metóda výpočtu ceny zo zoznamu:
    • Výpočet ceny v závislosti od obdobia - Na platobnom formulári používateľ špecifikuje aktivačné obdobie kódu a cena sa automaticky vypočíta podľa tabuľky nižšie. Používateľ dostane automaticky generovaný kód na odomknutie v odpovednom e-maile.
    • Výpočet obdobia v závislosti od ceny - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá svoju vlastnú hodnotu ceny a obdobie sa automaticky vypočíta podľa tabuľky nižšie. Používateľ dostane automaticky generovaný kód v odpovedi.
    • Trvalý kód - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá svoju vlastnú hodnotu ceny. Po platbe dostane kód zo zoznamu nižšie, ktorý zodpovedá vybranej cene, v odpovedi e-mailom.
    • Dar - Na platobnom formulári používateľ vyberie cenu zo zoznamu alebo zadá vlastnú hodnotu ceny. Pre aplikácie typu Dar sa kód na odomknutie negeneruje.
    • Dočasný kód s cenou závislou od obdobia a Dočasný kód s obdobím závislým od ceny - aplikácia dostane z API dočasný kód pre zariadenie a zobrazí ho používateľovi spolu s QR kódom, ktorý vedie na platobný formulár. Používateľ zaplatí za tento kód: cena závisí od zvolenej doby alebo doba závisí od zaplatenej ceny, ako pri metódach vyššie. Po zaplatení sa kód aktivuje iba pre toto zariadenie. Takýto kód nie je možné resetovať ani preniesť na iné zariadenie.

Pre skupinové aplikácie sú dostupné iba metódy Výpočet ceny v závislosti od obdobia a Výpočet obdobia v závislosti od ceny. Pri metóde Dar sa skúšobná doba nepoužíva.

Tabuľka Cenník určuje cenové úrovne. Riadok pridáte tlačidlom Pridať a odstránite tlačidlom Odstrániť. Stĺpce tabuľky závisia od metódy výpočtu ceny:

  • Obdobie, Cena - doba platnosti kódu (číslo a jednotka času: dni, mesiace, roky alebo navždy) a jeho cena.
  • Cena, Kód - pri metóde Trvalý kód: cena a kód, ktorý používateľ dostane po jej zaplatení (do 12 znakov).
  • Cena - pri metóde Dar: iba navrhované sumy.

Riadok označený prepínačom (popis Použiť predvolené) je v platobnom formulári predvolene vybraný.

Cena je nastavená v amerických dolároch. Minimálna cena je 1 americký dolár.

Zmeny sa ukladajú automaticky pri písaní alebo zmene hodnôt - tlačidlo Uložiť nie je. Správa sa zobrazí, len ak sa niečo nepodarilo uložiť. Kedykoľvek sa môžete vrátiť a urobiť zmeny neskôr.

Medzi krokmi prepínajte v hlavičke stránky - pri posúvaní zostáva hore. Ďalší krok je dostupný, keď je aktuálny vyplnený; prechod naň uloží aktuálny krok.

Ukážka

Na tejto stránke sa nastavujú hodnoty:

  • Dĺžka kódu - dĺžka generovaného kódu, ak sa používa.
  • Znaková sada kódu - sada znakov, z ktorých je kód generovaný:
    • Číselný kód - kód sa generuje iba z číslic 0, 1, 2, 3, 4, 5, 6, 7, 8, 9. Kód môže obsahovať úvodné nuly. Úvodné nuly sú pri overovaní kódu podstatné.
    • Alfanumerický kód - kód je generovaný použitím znakov 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, G, H, I, G, K, L, M, N, P, Q, R, S, T, U, V, X, Y, Z. Kód je vygenerovaný a odoslaný používateľovi pomocou veľkých písmen. Veľkosť písmen nie je dôležitá pri overovaní kódu.
  • Povoliť úvodné nuly v kóde - povoľuje úvodné nuly vo vygenerovanom kóde. Dostupné iba pre znakovú sadu Číselný kód.
  • Povoliť opätovné odoslanie kódu podľa ID zariadenia - umožňuje opätovné odoslanie kódu na rovnaký e-mail opakovaním kontroly identifikátora zariadenia. Dostupné iba pre jednotlivé aplikácie.
  • Návrhár ciferníkov - aplikácia je ciferník vytvorený v návrhári: tento krok namiesto platobného odkazu a príkladov kódu zobrazuje návrhár. Zapnuté pre ciferníky vytvorené na hlavnej stránke.
  • Dátum vydania - dátum, od ktorého je aplikácia dostupná bežným používateľom. Spolu s Bezplatné pre beta testerov po vydaní definuje bezplatné obdobie pre zariadenia, ktoré kontaktovali aplikáciu pred týmto dátumom.
  • Bezplatné pre beta testerov po vydaní - dĺžka bezplatného obdobia (vo vybranej Časová jednotka) udeleného zariadeniam, ktorých prvé volanie API sa uskutočnilo pred Dátum vydania. Kódy vytvorené pre takéto zariadenia získajú stav Neznáme.
  • Odkaz na overenie kódu - príklad odkazu, ktorý sa má použiť na overenie kódu.
  • Odkaz na platbu - platobný odkaz. Odkaz môžete skopírovať a vložiť do popisu aplikácie na webovej stránke, kde je aplikácia publikovaná. Pre každú doménu (https://pay-to-use.com pre všetky jazyky, https://pay-to-use.ru iba pre ruský jazyk) sa vygeneruje samostatný odkaz a QR kód, dostupné ako karty nad poľom odkazu. Odovzdávané parametre:
    • app - jedinečný identifikátor aplikácie. Povinný parameter.
    • amount - suma, ktorá bude uvedená v poli ceny pri nákupe. Predvolená cena je ignorovaná. Suma však nemôže byť menšia ako minimálna cena a nemôže byť nižšia ako minimálna cena stanovená pre aplikáciu. Voliteľný parameter.

Odkaz Odkaz na platbu sa stane verejne dostupným až po spustení aplikácie. Dovtedy použite nižšie uvedené tlačidlo Testovacia platba na otvorenie platobného formulára s podpísaným dočasným prístupovým tokenom - rovnaký formulár a spôsoby platby ako v skutočnosti, no peniaze sa v skutočnosti nestrhávajú: platba sa vytvorí priamo so stavom Test a plne funkčný kód (ak je relevantný) sa okamžite vygeneruje a odošle e-mailom bez toho, aby prešiel platobným systémom. Testovacie platby sú viditeľné v zozname Platby, označené stavom Test, ale sú vylúčené zo súčtov Zostatok.

Tlačidlo Testovacia platba otvorí rozbaľovací zoznam na výber domény (https://pay-to-use.com alebo https://pay-to-use.ru), na ktorej sa má otvoriť formulár testovacej platby - obe sú rovnako funkčné, výber má význam iba vtedy, ak potrebujete otestovať správanie špecifické pre danú lokalitu.

Ak chcete začať prijímať skutočné platby, vypnite Testovací režim. Predtým sa uistite, že všetky zadané údaje sú správne. Kľúče vygenerované aplikáciou nemožno zmeniť. Kým je testovací režim zapnutý, vedľa názvu aplikácie sa zobrazuje odznak Test. Opätovné zapnutie Testovací režim (po potvrdení) zastaví prijímanie skutočných platieb a tlačidlo Testovacia platba bude opäť dostupné.

Overenie kódu

Overenie kódu na odomknutie aplikácie sa vykonáva v 3 krokoch:

  1. Vytvorenie a odoslanie požiadavky na overenie kódu
  2. Kontroly na strane API
  3. Prijímanie a spracovanie odpovede API
Posielanie požiadavky

Na overenie kódu musí používateľ vašej aplikácie zadať kód do poľa v nastaveniach aplikácie.

/resources/settings/properties.xml
<properties>
	<property id="UnlockCode" type="string"></property>
	<property id="UnlockResult" type="string">Checking...</property>
	...
<properties>
/resources/settings/settings.xml
<settings>
	<setting propertyKey="@Properties.UnlockCode" title="@Strings.UnlockCode">
		<settingConfig type="alphaNumeric" maxLength="12"/>
	</setting>
	<setting propertyKey="@Properties.UnlockResult" title="@Strings.UnlockResult">
		<settingConfig type="alphaNumeric" readonly="true"/>
	</setting>
	...
</settings>

Potom musíte odoslať požiadavku na server API Pay-to-use:

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // URL API
		{
			"device" => ds.uniqueIdentifier, // jedinečný identifikátor zariadenia
			"app" => "6", // váš identifikátor aplikácie
			"model" => ds.partNumber, // číslo modelu zariadenia
			"code" => Application.Properties.getValue("UnlockCode") // hodnota kódu na odomknutie vo vašej aplikácii
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

Parametre požiadavky API:

  • url – https://api.pay-to-use.com. Používanie protokolu HTTPS je povinné.
  • Telo požiadavky (odovzdávané hodnoty). Slovník kľúčov a hodnôt:
    • device - jedinečný identifikátor zariadenia.
    • app - jedinečný identifikátor vašej aplikácie.
    • model – identifikátor modelu zariadenia. Voliteľný parameter. Údaje sa používajú na zobrazenie štatistík o nových zariadeniach.
    • code - kód na odomknutie, ktorý zadal používateľ vo vašich nastaveniach aplikácie.
  • Možnosti požiadavky:
    • :method - API podporuje metódy požiadaviek GET a POST.
    • :headers - pre metódu POST je potrebné prenášať parametre vo formáte JSON.
    • :responseType - odpoveď je vrátená vo formáte JSON.
  • responseCallback - odkaz na metódu spätného volania (callback), ktorá by mala prijať dva argumenty:
    • responseCode - kód hlavičky odpovede servera.
    • data - obsah, ak bola požiadavka úspešná, alebo null.
Kontroly na strane API

Ak sa API neprenášajú žiadne parametre, API vráti hlavičku HTTP/1.1 404 Not Found.

Ak sa aspoň jeden parameter prenesie do API, API vráti hlavičku HTTP/1.1 200 OK.

Odpoveď servera pozostáva z:

  • response - kód odpovede
  • msg - textový popis odpovede
  • expires - časová pečiatka UNIXTIME (ak je k dispozícii)

Skontroluje sa, či je odovzdaný identifikátor aplikácie správny. Aplikácia musí mať v čase platby stav Vydaná. V prípade chyby je vrátený kód odpovede 301.

Ak sa prenáša jedinečný identifikátor zariadenia, vyhľadá sa a uloží sa. Ak pri kontrole alebo ukladaní dochádza k chybám, vráti sa chybový kód 402. Ak sa nájde takýto návratový kód, ihneď napíšte na podporu na [email protected]

Ak je kód prenesený, pre aplikácie s metódami výpočtu Výpočet ceny v závislosti od obdobia a Výpočet obdobia v závislosti od ceny sa vykonajú nasledujúce kroky:

  • Ak je prenesený prázdny kód, odpojí sa od jedinečného identifikátora zariadenia definovaného v predchádzajúcich krokoch.
  • Ak sa prenesie neprázdny kód a nie je aktivovaný, kód sa aktivuje v závislosti na podmienkach ceny uvedenej pri nákupe kódu, bez ohľadu na dátum aktivácie.
  • Ak nebol prenesený žiadny kód alebo ak sa prenesený kód nenašiel, vráti sa chybový kód 201.
  • Aktivovaný kód sa skontroluje proti zariadeniu a ak bol počas aktivácie prenesený jedinečný identifikátor zariadenia iný ako uložený, vráti sa chybový kód 202.
  • Ak prenesený kód nemá dátum expirácie a všetky predchádzajúce kontroly boli úspešné, vráti sa kód 101.
  • Ak je kód časovo obmedzený, vykoná sa kontrola. Ak kľúč nie je expirovaný, vráti sa kód 101. Ak kód expiroval, vráti sa chybový kód 203.
  • Tento typ aplikácie vyžaduje, aby bol kód viazaný na zariadenie. Ak sa neprenesie jedinečný identifikátor zariadenia, vráti sa chybový kód 304.

Pre aplikáciu s Trvalý kód sa kontroluje iba dostupnosť kódu v čase nákupu. Ak sa nájde kód, vráti sa kód 101. Ak sa žiadny kód nenájde, vráti sa chybový kód 201.

Pre aplikáciu s metódou výpočtu Dar sa kód nekontroluje. Vráti sa vždy kód 101.

Ak sa odošle prázdny kód a aplikácia má vyplnené pole Dátum vydania, kontroluje sa obdobie pre beta testerov: ak zariadenie prvýkrát kontaktovalo API pred dátumom vydania a obdobie Bezplatné pre beta testerov po vydaní ešte neuplynulo, vráti sa kód 103.

Ak je zapnutá možnosť Povoliť opätovné odoslanie kódu podľa ID zariadenia a kód sa neodošle, vyhľadá sa platný kód už priradený k zariadeniu. Ak sa nájde, vráti sa kód 101 spolu so samotným kódom.

Ak predchádzajúce kontroly neboli úspešné, skontroluje sa testovacie obdobie. Ak uplynulo viac času od prvotného kontaktu so zariadením než je aktuálna konfigurácia aplikácie, vráti sa chybový kód 204. Ak skúšobné obdobie ešte neuplynulo, vráti sa chybový kód 102.

Ak sa prenáša iba identifikátor aplikácie a neprenesie sa ani kľúč na odomknutie ani jedinečný identifikátor zariadenia, vráti sa chybový kód 303.

Ak vrátená odpoveď je 500, mali by ste napísať na podporu na [email protected]

Nižšie je tabuľka všetkých vrátených kódov:

Kód Správa
101 Metódy výpočtu Výpočet ceny v závislosti od obdobia a Výpočet obdobia v závislosti od ceny:
  • Aktívny navždy
{
	"response":101,
	"msg":"Active forever",
	"expires":0
}
  • Aktívny do [dátum]
{
	"response":101,
	"msg":"Active until 11 Apr 2027",
	"expires":1807409268
}
Trvalý kód:
{
	"response":101,
	"msg":"The code check was successfull",
	"expires":0
}
Dar:
{
	"response":101,
	"msg":"No code check required",
	"expires":0
}
102
{
	"response":102,
	"msg":"Trial period expires in 1d 18h 34m",
	"expires":1795207325
}
103
{
	"response":103,
	"msg":"Free for beta tester until 12 Dec 2026",
	"expires":1797041268
}
201
{
	"response":201,
	"msg":"Code not found"
}
202
{
	"response":202,
	"msg":"Used on the another device"
}
203
{
	"response":203,
	"msg":"Expiration: 29 Sep 2026",
	"expires":1790647668
}
204
{
	"response":204,
	"msg":"Trial period expired"
}
301
{
	"response":301,
	"msg":"Application not found"
}
302
{
	"response":302,
	"msg":"Term undefined"
}
303
{
	"response":303,
	"msg":"Not enough arguments"
}
304
{
	"response":304,
	"msg":"Device is nesessary"
}
401
{
	"response":401,
	"msg":"Error code saving"
}
402
{
	"response":402,
	"msg":"Error device saving"
}
500
{
	"response":500,
	"msg":"Unknown error"
}
Kontrola odpovede

Potom by ste mali skontrolovať odpoveď zo servera Pay-to-use API:

/source/background.mc
function onReceive(responseHeader, data) as Void {
	if (responseHeader == 200) { Toybox.Background.exit(data); }
}

Môžete skontrolovať všetky hlavičky a kódy, môžete zobraziť vlastné správy pre pohodlie používateľa, ale v najjednoduchšej forme bude overenie vyzerať približne takto:

/source/app.mc
function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Môžete zobraziť data["msg"] v poli vlastností s názvom "UnlockResult".
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// Overenie kódu zlyhalo
			// Platené funkcie NIE sú k dispozícii
			...
		} else {
			// Kontrola kódu bola úspešná alebo chyba je vaša vina alebo vina API
			// Platené funkcie sú k dispozícii
			...
		}
	}
}

Kódy na odomknutie

Po prechode do tejto sekcie sa otvorí zoznam kódov na odomknutie.

Zoznam kódov na odomknutie

Môžete vyhľadávať v poli e-mailu alebo kódu v hornej vyhľadávacej lište. Nájdené kódy budú zobrazené v zozname. Môžete použiť celý alebo časť e-mailu alebo kódu ako kritérium vyhľadávania. Zhody budú zvýraznené farbou. Vyhľadávanie a filtre fungujú súčasne a nevylučujú sa navzájom.

Posledný použitý filter je uložený pre používateľa. To znamená, že pri ďalšej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtre sú k dispozícii pre zoznam kódov na odomknutie:

  • Stĺpce - vyberte stĺpce tabuľky, ktoré sa majú zobraziť v zozname kódov na odomknutie.
  • Aplikácia - zobraziť len kódy na odomknutie pre vybrané aplikácie.
  • Stav - zobraziť len kódy na odomknutie, ktoré sú vo vybraných stavoch.

Zoznam stĺpcov v tabuľke kódov na odomknutie:

  • Aplikácia - vaša aplikácia. Môžete kliknúť na odkaz, aby ste upravili jej nastavenia.
  • Kód - kód na odomknutie.
  • E-mail - e-mailová adresa spojená s registráciou kódu na odomknutie. Táto adresa sa používa na vyhľadávanie kódov na odomknutie klienta v časti Moje nákupy webovej stránky. Táto časť je prístupná používateľom.
  • Obdobie - obdobie platnosti odoslaného kódu (špecifikované v nastaveniach aplikácie). Platnosť je nastavená pre kód v súlade s podmienkami nastavení aplikácie v čase jeho vytvorenia.
  • Stav - stav kódu na odomknutie. (pozri Stav kódu na odomknutie)
  • Vytvorené - dátum vytvorenia kódu na odomknutie.
  • Jazyk - jazyk používateľa, používaný pre správy s kódom.
  • Aktivácia - dátum aktivácie kódu. Nastaví sa v momente, keď sa toto konkrétne zariadenie používateľa prvýkrát pripojí k službe PayToUse API a odošle tento kód. Stav kódu sa zmení na Aktivované. Aktivovať možno iba neaktívny kód. Ak aktívny kód odošle zariadenie s iným identifikátorom, API vráti chybu 202. S jedným kódom môže byť prepojené iba jedno zariadenie.
  • Vypršanie platnosti - dátum, kedy vyprší platnosť aktivácie kódu. Nastavuje sa pre kódy, ktoré majú obmedzenú platnosť pri aktivácii kódu. Pre kódy s neobmedzeným vypršaním platnosti je dátum nevyplnený.
  • Odstránené - dátum vymazania kódu. Po vymazaní je stav kódu nastavený na Neznáme.
  • Zariadenie - jedinečný identifikátor zariadenia, ku ktorému je kód priradený.
  • Prvé volanie zariadenia - dátum prvého volania API zo zariadenia. Od tohto dátumu sa počíta skúšobná doba a obdobie pre beta testerov.
  • Posledné volanie zariadenia - dátum posledného volania API zo zariadenia. Umožňuje overiť, či sa aplikácia stále používa.
  • Platba # - jedinečné poradové číslo platby. Kliknutím na odkaz môžete zobraziť podrobnosti platby.
  • Poznámky - poznámky zadané pri ručnom vytváraní kódov.
  • Tlačidlá pre akcie s kódmi na odomknutie. Napríklad vymazanie.

Stav kódu na odomknutie

Počas svojho životného cyklu kód na odomknutie prechádza rôznymi stavmi, ktoré môžu byť sledované pomocou stavu kódu.

Stav Popis
Dostupné Stav sa priraďuje kódu na odomknutie, s ktorým neboli vykonané žiadne akcie alebo ktorému bolo resetované prepojenie so zariadením.
Aktivované Stav je nastavený pre kód s nastaveným dátumom aktivácie. Dátum aktivácie sa nastavuje, keď zariadenie úspešne získa prístup k službe PayToUse API po prvýkrát. Okrem toho, pri aktivácii kódu sa nastaví aj dátum expirácie kódu.
Vypršaný Stav sa nastaví pre kód s vypršanou platnosťou. Odpojenie kódu od zariadenia neresetuje dátum skončenia platnosti kódu. Overenie kódu s týmto stavom vráti chybu 203. (pozri Kontroly na strane API)
Neznáme Stav je nastavený, keď je kód vymazaný. Overenie kódu s týmto stavom vráti chybu 201. (pozri Kontroly na strane API)
Neznáme Stav sa nastaví pre kód vytvorený pre zariadenie, ktorého prvé volanie API sa uskutočnilo pred Dátum vydania aplikácie - namiesto bežnej skúšobnej doby alebo platenej aktivácie sa mu udelí bezplatné obdobie, ako je nastavené v Bezplatné pre beta testerov po vydaní.
Neznáme Stav sa nastaví pre kód zdieľaný viacerými zoskupenými aplikáciami. Nie je viazaný na jednu aplikáciu a nezobrazuje sa v zozname kódov jednotlivých aplikácií v skupine.
Neznáme Rovnako ako Neznáme, ale kód už nie je dostupný: bol odstránený alebo, pri skupine s kľúčom iba pre jednu aplikáciu, už bol aktivovaný v jednej z aplikácií skupiny. Odstránením kódu skupiny sa odstránia aj jeho kópie vo všetkých aplikáciách skupiny.
Neznáme Stav sa nastaví pre kód patriaci aplikácii v rámci skupiny, keď je odstránený jednotlivo, zatiaľ čo samotný kód skupiny zostáva.

Podrobnosti kódu

Kliknutím na kód v zozname sa otvorí stránka podrobností kódu. Zobrazuje rovnaké polia ako zoznam a tlačidlá akcií s kódom:

  • Resetovať - odpojí kód od zariadenia a vynuluje dátum aktivácie. Stav kódu sa zmení na Dostupné a kód je možné aktivovať na inom zariadení, napríklad keď používateľ vymenil zariadenie. Dátum skončenia platnosti už aktivovaného kódu sa nevynuluje. Tlačidlo nie je dostupné pre aplikácie s dočasnými kódmi, pretože takýto kód možno použiť iba na jednom zariadení.
  • Aktivovať - dostupné pre dočasný kód, ktorý ešte nebol zaplatený. Zadajte e-mail používateľa a dobu platnosti kódu: kód sa aktivuje pre zariadenie, ku ktorému je priradený, akoby bol zaplatený. Použite napríklad na bezplatné poskytnutie aplikácie používateľovi.
  • Poslať kód - odošle e-mail s kódom a jeho podrobnosťami na e-mail kódu. Vyberte Jazyk správy. Ak je označené Poslať kópiu vývojárovi, kópia e-mailu sa odošle na kontaktný e-mail aplikácie. Použite, keď používateľ stratil e-mail s kódom.
  • Zmeniť e-mail - zmení e-mail kódu. Pri kóde skupiny sa e-mail zmení pre kód skupiny a všetky jeho kópie. Ak bol kód získaný na základe platby, zmení sa aj e-mail platby. Používateľ potom nájde kód v časti Moje nákupy podľa nového e-mailu.
  • Odstrániť - odstráni kód. Stav kódu sa zmení na Neznáme a overenie kódu vráti chybu 201. Nezaplatený dočasný kód sa odstráni úplne.

Akcie s kódom sú dostupné aj na stránke podrobností platby, ak bol k platbe odoslaný kód.

Vytvoriť

Tlačidlo Vytvoriť v záhlaví zoznamu kódov na odomknutie otvorí formulár na vytvorenie kódov bez platby. Napríklad pre beta testerov, recenzentov alebo používateľov, ktorí zaplatili iným spôsobom. Polia formulára:

  • E-mail - adresa, na ktorú sa odošlú vytvorené kódy. Kópia e-mailu sa odošle na kontaktný e-mail aplikácie.
  • Aplikácia - aplikácia, pre ktorú sa kódy vytvárajú. Dostupné sú iba aplikácie v stavoch Test a Spustiť s metódou výpočtu ceny Výpočet ceny v závislosti od obdobia alebo Výpočet obdobia v závislosti od ceny.
  • Obdobie a Časová jednotka - doba platnosti kódov. Počíta sa od okamihu aktivácie kódu na zariadení.
  • Počet - počet kódov na vytvorenie.
  • Poznámky - ľubovoľný text uložený s kódmi. Zobrazuje sa v stĺpci Poznámky zoznamu.
  • Vložiť poznámky do e-mailu - pridá poznámky do e-mailu s kódmi.

Kódy sa generujú podľa nastavení kódu aplikácie (dĺžka a sada znakov). Po uložení sa zobrazí zoznam vytvorených kódov a odošle sa e-mail.

Nahrať

Tlačidlo Nahrať umožňuje načítať kódy vydané mimo PayToUse, napríklad pri prechode z iného licenčného systému. Vyberte aplikáciu, súbor a parametre súboru:

  • Formát súboru - CSV, kódovanie UTF-8. Maximálna veľkosť súboru je uvedená vo formulári načítania.
  • obsahuje hlavičky - označte, ak prvý riadok súboru obsahuje názvy stĺpcov. Prvý riadok sa potom preskočí.
  • Oddeľovač - bodkočiarka, čiarka alebo tabulátor.

Stĺpce súboru v tomto poradí:

  1. Kód - kód na odomknutie, povinný. Prevedie sa na veľké písmená a skráti na 12 znakov. Kódy, ktoré pre aplikáciu už existujú, sa preskočia.
  2. E-mail - e-mail používateľa.
  3. Vytvorené - dátum vytvorenia: dátum alebo časová značka UNIXTIME. Ak je prázdne, použije sa dátum načítania.
  4. Vypršanie platnosti - dátum skončenia platnosti: dátum alebo časová značka UNIXTIME. Nechajte prázdne, ak kód ešte nebol aktivovaný alebo nemá dátum skončenia platnosti.
  5. Obdobie - doba platnosti po aktivácii: číslo a jednotka, napríklad 12h, 30d, 6m alebo 1y. Ak je prázdne, kód platí navždy.

Po načítaní sa zobrazí tabuľka načítaných riadkov. Nenačítané riadky sú zvýraznené červenou a správa ukazuje, koľko riadkov bolo pridaných z celkového počtu. Pri načítaní sa používateľom e-maily neodosielajú.

Stiahnuť

Tlačidlo Stiahnuť stiahne zoznam kódov na odomknutie do súboru CSV. Vo formulári vyberte polia, ktoré sa majú zahrnúť do súboru. Súbor obsahuje všetky kódy zodpovedajúce aktuálnym filtrom a vyhľadávaniu, nielen kódy aktuálnej stránky. Vybrané polia sa zapamätajú pre ďalšie stiahnutie.

Platby

Pri prechode do tejto sekcie sa zobrazí zoznam platieb používateľa.

Na prijímanie platieb sa používajú nasledujúce platobné systémy:

Systém Popis
Poplatok platobného systému je od 2,9% + 0,30 USD za každé úspešné zaťaženie karty. Podporované sú karty, peňaženky a ďalšie platobné možnosti. Poplatok závisí od spôsobu platby a môže sa líšiť od poplatku za platbu kartou. Podrobné informácie o poplatkoch účtovaných platobným systémom nájdete na webovej stránke platobného systému.
Poplatok platobného systému je od 3,4% + 0,30 USD za každú úspešnú platbu. Sú podporované karty a PayPal. Podrobné informácie o poplatkoch účtovaných platobným systémom nájdete na webovej stránke platobného systému.
Poplatok platobného systému je od 3,9% za každú úspešnú platbu. Sú podporované karty a ďalšie platobné možnosti. Poplatok závisí od spôsobu platby. Podrobné informácie o poplatkoch účtovaných platobným systémom nájdete na webovej stránke platobného systému.

Po odpočítaní poplatkov platobného systému si PayToUse účtuje poplatok 13%. Neustále pracujeme na znižovaní poplatkov.

Ak v platobnom systéme vzniknú akékoľvek spory alebo vrátenia, sankcie platobného systému sa prenášajú na vývojára. Preto by ste nemali dopustiť, aby takéto situácie nastali. V sporných situáciách sa poplatok PayToUse neúčtuje.

Zoznam platieb

Môžete vyhľadávať v poli e-mailu alebo odoslaného kódu v hornej vyhľadávacej lište. Nájdené platby sa zobrazia v zozname. Môžete použiť celý alebo časť e-mailu alebo odoslaného kódu ako kritérium vyhľadávania. Zhody sa zvýraznia farebne. Vyhľadávanie a filtre fungujú súčasne a nevylučujú sa navzájom.

Posledný použitý filter sa ukladá pre používateľa. To znamená, že pri nasledujúcej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtre sú k dispozícii pre zoznam platieb:

  • Stĺpce - vyberte stĺpce tabuľky, ktoré chcete zobraziť v zozname platieb.
  • Obdobie - zobraziť iba platby vytvorené vo vybranom rozsahu dátumov.
  • Aplikácia - zobrazovanie platieb iba pre vybrané aplikácie.
  • Systém - zobraziť platby iba z vybraných platobných systémov.
  • Stav - zobraziť platby iba s vybranými stavmi.

Zoznam stĺpcov v tabuľke platieb:

  • Aplikácia - vaša aplikácia. Môžete kliknúť na odkaz, aby ste upravili jej nastavenia.
  • # - jedinečné poradové číslo platby. Automaticky sa priradí k platbe, keď používateľ prejde z formulára platby na stránku platby v platobnom systéme. Kliknite na odkaz, aby ste zobrazili podrobnosti platby.
  • Komentáre - správa od používateľa zadaná do formulára platby.
  • Systém - platobný systém vybraný používateľom.
  • Stav - stav platby. (pozri Stav platby)
  • E-mail - e-mail používateľa uvedený vo formulári platby.
  • Obdobie - platnosť odoslaného kódu (určená v nastaveniach aplikácie).
  • Jazyk - jazyk platobného formulára zvolený používateľom.
  • Vytvorené - dátum vytvorenia platby.
  • Suma faktúry - suma platby účtovanej používateľovi. Špecifikovaná vo formulári platby v závislosti na nastaveniach aplikácie.
  • Dátum platby - dátum platby.
  • Suma platby - suma platby potvrdená platobným systémom.
  • Odoslaný kód - kód odoslaný používateľovi.
  • Dostupná suma - dostupná čiastka na výber.
  • Suma výplaty - čiastka vybratých prostriedkov za platbu.

Podrobnosti o platbe

Kliknutím na # platby v zozname sa otvorí jej stránka s podrobnosťami.

Okrem polí uvedených vyššie stránka s podrobnosťami zobrazuje:

  • Kód - kód zadaný kupujúcim vo formulári platby pred jeho kontrolou a aktiváciou. Zobrazuje sa iba pre aplikácie s dočasnými kódmi viazanými na zariadenie.
  • Suma platby (hrubá) - suma potvrdená platobným systémom, pred poplatkami platobného systému a PayToUse.
  • Suma platby (čistá) - suma potvrdená platobným systémom, po poplatkoch platobného systému a PayToUse.
  • Identifikátory platby - identifikátory pridelené platobným systémom, použité na vyhľadanie platby v ňom v prípade potreby. Zobrazené polia závisia od platobného systému:
    • Stripe: Payment Intent, Číslo potvrdenky, Posledné 4 číslice.
    • PayPal: ID platby, ID platiteľa, ID transakcie.
    • Robokassa: ID platby, ID1, ID2.

Ak bol k platbe odoslaný kód, na stránke podrobností platby sú dostupné tlačidlá Resetovať kód, Poslať kód a Zmeniť e-mail. Fungujú rovnako ako na stránke podrobností kódu. (pozri Podrobnosti kódu)

Stav platby

Počas svojho životného cyklu platba prechádza rôznymi stavmi, ktoré možno sledovať podľa stavu platby.

Stav Popis
Neúplné Stav je priradený platbám, pre ktoré neboli vykonané žiadne akcie. Platba sa vytvorí ihneď, ako používateľ prejde z formulára platby na formulár platobného systému. Platbe je priradené jedinečné sériové číslo, ako aj základné atribúty platby: čiastka, platobný systém, dátum.
Úspešné Stav je priradený platbám, ktoré dostali pozitívnu odpoveď od platobného systému. Ďalším krokom je odoslanie e-mailu používateľovi s vygenerovaným kódom alebo inými údajmi v závislosti od nastavení aplikácie. Ak platba zostane v tomto stave, je potrebné venovať jej osobitnú pozornosť, pretože nasledujúce kroky neboli vykonané.
Chyba Stav je priradený platbám, pre ktoré bola prijatá negatívna odpoveď od platobného systému. Ďalšie kroky sa nevykonávajú. Takýmto platbám je potrebné venovať osobitnú pozornosť, pretože stav na strane platobného systému môže byť spracovaný s oneskorením.
Čakajúce Stav je priradený platbám, pre ktoré bola prijatá pozitívna odpoveď od platobného systému a všetky následné kroky boli úspešne dokončené. Výber pre platby s týmto stavom nie je k dispozícii. Platby sa automaticky presúvajú do nasledujúceho stavu po 7 dňoch.
Dostupné Výber je k dispozícii pre platby v tomto stave.
Odosielanie Stav sa priraďuje platbám zahrnutým v nasledujúcom výbere. Ak je výber zrušený alebo zamietnutý, stav platby sa vráti na Dostupné.
Odoslané Stav sa priraďuje platbám, za ktoré bol vykonaný výber. Čaká sa na potvrdenie prijatia prostriedkov.
Dokončené Stav sa priraďuje platbám s úspešnými výbermi. Stav môžete nastaviť ručne potvrdením výberu v príslušnej sekcii. Stav sa tiež automaticky zmení 14 dní po vykonaní výberu platby.
Vrátené Platby, za ktoré boli vrátené peniaze, prechádzajú do tohto stavu. Pri vrátení peňazí sa účtuje poplatok za vrátenie. Poplatok sa odpočíta zo sumy výberu.
Vrátenie uzavreté Vrátenie peňazí, ktoré bolo zahrnuté do už odoslaného výberu. Poplatok za vrátenie sa namiesto toho odpočíta zo zostatku vývojára, keďže vyplatenú sumu už nemožno znížiť.
Spor Kupujúci napadol platbu (chargeback) v platobnom systéme. Výsledok zatiaľ nie je známy.
Spor uzavretý Spor bol vyriešený. Podobne ako pri vrátení peňazí sa akýkoľvek poplatok za spor účtovaný platobným systémom prenáša na vývojára.
Zrušené Platba bola zrušená pred jej dokončením.
Neznáme Priradí sa pri zosúlaďovaní záznamov o platbách s výkazom platobného systému, ktorého text stavu nezodpovedá žiadnemu z vyššie uvedených známych stavov. Vyžaduje manuálnu kontrolu.
Test Testovacia platba vykonaná cez Testovací režim aplikácie, kým je v stave Test, pred jej spustením. Suma aj prípadný vygenerovaný kód sú skutočné, no peniaze sa v skutočnosti nestrhávajú a platba je vylúčená zo súčtov na nástenke.

Stiahnuť

Tlačidlo Stiahnuť v záhlaví zoznamu platieb stiahne zoznam do súboru Excel (XLSX). Súbor obsahuje stĺpce vybrané vo filtri Stĺpce v rovnakom poradí a všetky platby zodpovedajúce aktuálnym filtrom a vyhľadávaniu, nielen platby aktuálnej stránky.

Výbery

Po prechode do tejto sekcie sa zobrazí zoznam vašich výberov.

Vybrať prostriedky

Tlačidlo „Vybrať“ slúži na odoslanie žiadosti o prevod vašich zarobených prostriedkov.

Po kliknutí na toto tlačidlo sa otvorí modálne okno, v ktorom je potrebné zadať platobné údaje pre prevod.

Dôležitá poznámka: Systém automaticky použije na výber celú dostupnú sumu uvedenú v príslušnom poli. Nemôžete zadať ľubovoľnú sumu, ktorá je nižšia ako dostupný zostatok. Celková suma výberu je súčtom všetkých platieb, ktoré majú stav „dostupné na výber“.

V modálnom okne môžete zvoliť sumu a menu pre výber. Dostupné meny závisia od vašich platobných metód.

Poznámka: Ak vybraná mena nie je podporovaná pre zvolený spôsob výberu, žiadosť o výber bude zamietnutá.

Zoznam výberov

Posledné použité filtre sa ukladajú pre používateľa. To znamená, že pri ďalšej návšteve stránky sa posledný použitý filter automaticky aplikuje. Filtre sú k dispozícii pre zoznam výberov:

  • Stĺpce - zobraziť iba vybrané stĺpce v zozname výberov.
  • Stav - zobraziť iba výbery, ktoré sú vo vybraných stavoch.

Zoznam stĺpcov v tabuľke výberov:

  • # - jedinečné poradové číslo výberu. Priradí sa výberu automaticky pri jeho uložení. Kliknite na odkaz pre zobrazenie detailov výberu.
  • Stav - stav výberu. (pozri Stav výberu)
  • Vytvorené - dátum požiadavky na výber.
  • Suma - suma výberu.
  • Výber - dátum odoslania výberu.
  • Tlačidlá pre akcie s výbermi. Napríklad potvrdenie.

Výber môžete potvrdiť, keď je v stave Odoslané.

Podrobnosti o výbere

Kliknutím na # výberu v zozname sa otvorí stránka jeho podrobností. Okrem polí zoznamu zobrazuje Podrobnosti - platobné údaje uvedené v žiadosti o výber, na ktoré sa prostriedky prevádzajú.

Nižšie je zoznam platieb zahrnutých vo výbere. Sú preň dostupné filtre Stĺpce, Aplikácia, Systém a Stav, rovnako ako v zozname platieb. (pozri Zoznam platieb)

Stav výberu

Počas svojho životného cyklu sa výber dostane do rôznych stavov, ktoré možno sledovať podľa stavu výberu.

Stav Popis
Čakajúce Stav sa priradí výberom pri vytvorení, keď s nimi ešte neboli vykonané žiadne akcie.
Zrušené Stav sa priraďuje zrušeným výberom. Zrušenie môže mať rôzne dôvody. Napríklad nie je uvedený spôsob prijatia prostriedkov. Všetky platby z tohto výberu prejdú do stavu Dostupné a sú opäť k dispozícii na výber.
Odoslané Stav sa nastaví pre výber prostriedkov pri jeho odoslaní.
Dokončené Stav sa nastaví ručne, keď vývojár potvrdí prijatie prostriedkov, alebo automaticky 14 dní po odoslaní.
Zamietnuté Stav sa nastaví pre výber, keď banka alebo platobný systém vráti finančné prostriedky po odoslaní. Všetky platby z tohto výberu prejdú do stavu Dostupné a sú opäť k dispozícii na výber.

Návrhár ciferníkov

Návrhár vytvára ciferníky Garmin Connect IQ pre vašu aplikáciu bez programovania. Rozmiestnite prvky na obrazovke každého modelu hodiniek, vyberte, čo zobrazujú a ktoré z nich sú platené, a stiahnite si hotový súbor: .prg na inštaláciu do vlastných hodiniek na testovanie alebo .iq na zverejnenie v Connect IQ Store.

Hotový ciferník sám overuje platbu cez PayToUse podľa spôsobu platby aplikácie. Nemusíte písať žiadny kód.

Návrhár sa otvára tlačidlom s raketou vedľa názvu aplikácie na stránke aplikácie.

Kľúč vývojára Connect IQ

Každý súbor .prg a .iq sa podpisuje kľúčom vývojára — súkromným kľúčom RSA 4096 bitov. Nastavuje sa raz v Profile a používa sa pre všetky ciferníky vývojára.

  • Ak už máte aplikácie v Connect IQ Store, nahrajte kľúč, ktorým ste ich podpísali: súbor developer_key vytvorený Connect IQ SDK (napríklad príkazom "Monkey C: Generate a Developer Key" vo Visual Studio Code). Aplikáciu zverejnenú v obchode možno aktualizovať iba rovnakým kľúčom.
  • Ak ešte nemáte kľúč, vygenerujte ho tlačidlom „Vygenerovať nový kľúč“. Takýto kľúč je vhodný na inštaláciu ciferníkov do hodiniek a pre nové aplikácie v obchode, ale aplikácie už zverejnené s iným kľúčom ním aktualizovať nemožno.
  • Stiahnite si kľúč a uschovajte kópiu na bezpečnom mieste. Ak sa kľúč stratí, aplikácie zverejnené s ním už nebude možné v obchode aktualizovať.
  • Prijímajú sa súbory vo formáte DER alebo PEM. Kľúč nesmie byť chránený heslom.

Dôležité: výmena kľúča ovplyvní všetky ciferníky vývojára. Predchádzajúci kľúč zostáva uložený na serveri, nové zostavenia sa však podpisujú novým.

Modely hodiniek

Zoznam modelov dostupných v návrhári nastavuje administrátor na stránke Modely hodiniek: okrúhle a obdĺžnikové modely s Connect IQ 4 a novším. V návrhári sa modely pre ciferník vyberajú tlačidlom Modely.

Každý model má vlastné rozloženie: poloha, veľkosť a písmo prvkov sa nastavujú samostatne, zatiaľ čo zoznam prvkov, funkcie a nastavenia platby sú spoločné pre všetky modely. Novo pridaný model dostane rozloženie aktuálneho modelu prepočítané na jeho obrazovku.

  • Hodinky / Obrazovka - zobraziť obrazovku na obrázku hodiniek alebo iba obrazovku.
  • Skutočná veľkosť - zobraziť hodinky v skutočnej veľkosti.
  • Always On - náhľad režimu Always On obrazoviek AMOLED.

Prvky

Ciferník sa skladá z prvkov štyroch typov:

  • Text - zobrazuje hodnotu funkcie: čas, dátum, kroky, tep, počasie a podobne.
  • Statický text - text, ktorý zadáte sami.
  • Ručičky - analógová hodinová, minútová a sekundová ručička.
  • Obrázok - obrázok: pozadie alebo vrstva nad ostatnými prvkami.

Prvky sa vykresľujú v poradí zoznamu na karte Prvky: prvý je spodná vrstva. Poradie sa mení šípkami v zozname a tlačidlami Dozadu a Dopredu.

Prvky sa presúvajú myšou alebo šípkami na klávesnici (o 1 px, so Shift o 10 px). Ctrl+D prvok duplikuje, Ctrl+C / Ctrl+V skopírujú jeho polohu do iného modelu, Delete ho odstráni. Tlačidlo Kopírovať do všetkých modelov prenesie polohu prvku do všetkých vybraných modelov. Tlačidlo Kopírovať všetko do všetkých modelov nahradí rozloženia všetkých ostatných modelov rozložením aktuálneho modelu: všetky prvky a pozadie, prispôsobené každej obrazovke.

Funkcie a platba

Textový prvok môže mať niekoľko funkcií. Jedna z nich sa zobrazuje predvolene; ak je zapnuté Používateľ si môže vybrať funkciu v nastaveniach, používateľ hodiniek si vyberie funkciu v nastaveniach ciferníka v Garmin Connect.

Každú funkciu každého prvku možno označiť ako platenú: tá istá funkcia môže byť v jednom prvku bezplatná a v inom platená. Karta Funkcie zobrazuje všetky použité funkcie a prvky v jednej tabuľke.

Funkcie označené hviezdičkou vyžadujú ďalšie povolenie (história snímačov, profil používateľa alebo poloha), ktoré obchod zobrazí pri inštalácii ciferníka. Povolenie sa pridá do ciferníka, iba ak používa takéto funkcie. Východ a západ slnka, ako aj ikony deň/noc potrebujú polohu: poslednú polohu GPS hodiniek (aktualizuje ju každá aktivita s GPS), inak miesto predpovede počasia.

Bez platby sa ciferník správa podľa spôsobu platby aplikácie:

Spôsob platby Bez platby
Výpočet ceny v závislosti od obdobia, Výpočet obdobia v závislosti od ceny, Trvalý kód Platené funkcie zobrazujú „paid“, platené obrázky sa skryjú. Kód na odomknutie sa zadáva v nastaveniach ciferníka; QR kód stránky nákupu je v ponuke nastavení v hodinkách.
Dočasný kód s cenou závislou od obdobia, Dočasný kód s obdobím závislým od ceny Ak ciferník používa platené funkcie, zobrazí uzamknutú obrazovku s kódom hodiniek a QR kódom stránky platby.
Dar Platba sa nekontroluje, označenia platenia sa ignorujú.

Na dotykových obrazovkách ťuknutie na uzamknutý ciferník sprístupní všetky funkcie na 15 minút na vyskúšanie.

Ikony

Textový prvok môže zobrazovať ikonu vedľa hodnoty funkcie. Ikona patrí funkcii v celom ciferníku: mení sa v stĺpci Ikona tabuľky funkcií prvku alebo na karte Funkcie a zmena platí pre všetky prvky s touto funkciou.

  • Zo slovníka (predvolene) - ikona, ktorú správca nastavil pre túto funkciu v slovníku ikon.
  • Bez ikony - funkcia sa zobrazuje bez ikony.
  • Jedna ikona - ľubovoľná ikona zo spoločnej knižnice alebo z vašich vlastných ikon.
  • Sada - ikona závisí od hodnoty funkcie: použije sa prvý riadok, ktorého hodnota „do“ nie je menšia ako hodnota, posledný riadok platí pre všetky väčšie hodnoty. S „Deň / noc“ má každý riadok vlastnú nočnú ikonu, ktorá sa používa od západu do východu slnka.

Hodnoty pre sady: batéria - nabitie v %, budíky - ich počet, pripojenie telefónu a nerušiť - 1 alebo 0, mesiac - vek v dňoch, vietor - smer v stupňoch, počasie - kód stavu; ostatné funkcie - ich číslo bez jednotiek. Počas nabíjania sa ikony batérie zobrazujú postupne.

Nastavenie prvku Zobraziť vyberá text a ikonu, iba text alebo iba ikonu. Poloha ikony voči textu, jej veľkosť, farba, medzera a posun sa nastavujú v rozložení každého modelu. Zarovnanie prvku sa vzťahuje na celý blok: text, medzeru a ikonu spolu.

Vlastné ikony sa pridávajú na karte Ciferník v sekcii Ikony ciferníka: súbory SVG (aj viac naraz) alebo písmo TTF, ktorého každý znak sa stane ikonou. Požiadavky na SVG:

  • ikony sú jednofarebné: farby súboru sa ignorujú, ikona sa kreslí farbou vybranou v návrhári;
  • používajú sa iba vyplnené tvary; čiary bez výplne (stroke) treba vo vektorovom editore previesť na tvary (napríklad „Ťah na cestu“ v Inkscape alebo „Outline Stroke“ vo Figme a Illustratori);
  • otvory musia byť skutočné výrezy (zložená cesta alebo pravidlo výplne evenodd): biely tvar na čiernom sa stane vyplnenou plochou;
  • veľkosť ikony je viewBox súboru; prechody, masky, text a triedy CSS nie sú podporované.

Na hodinkách sa ikony pri zostavení ciferníka prevedú na bitmapy potrebnej veľkosti.

Písma a obrázky

  • Systémové písma hodiniek sú dostupné pre každý model. Číselné písma obsahujú iba číslice a niekoľko znakov.
  • Vlastné písma TTF alebo OTF sa nahrávajú na karte Ciferník a prevádzajú sa na bitmapy pre každý model a veľkosť. Model môže mať spolu najviac 12 rôznych veľkostí vlastných písiem a ikon.
  • Obrázky (PNG, JPEG, GIF, WebP do 2000×2000) sa nahrávajú na tej istej karte. Obrázok buď vyplní obrazovku ľubovoľného modelu, alebo má vlastnú veľkosť; pre každý model sa prispôsobí, priehľadnosť sa zachová. Najviac 8 rôznych obrázkov alebo veľkostí na model.
  • Obrázky zaberajú grafickú pamäť hodiniek; návrhár ukazuje, koľko je jej využitej na aktuálnom modeli.

Režim Always On

Na obrazovkách AMOLED v režime Always On ciferník zobrazuje iba prvky s označením Zobraziť v režime Always On, na čiernom pozadí a s malým posunom každú minútu na ochranu obrazovky. Garmin v tomto režime povoľuje najviac 10 % svietiacich pixelov; návrhár túto hodnotu zobrazuje nad obrazovkou. Sekundy a sekundová ručička sa v tomto režime nezobrazujú.

Zostavenie

  • Zostaviť pre tieto hodinky (.prg) - súbor pre aktuálny model na inštaláciu do hodiniek.
  • Zostaviť pre Connect IQ Store (.iq) - balík pre všetky vybrané modely na zverejnenie v Connect IQ Store. Každé zostavenie .iq dostane nové číslo verzie.

Zostavenia sa zaraďujú do frontu a zvyčajne trvajú asi minútu. Karta Zostavenia zobrazuje stav, odkaz na stiahnutie a záznam zostavenia.

UUID aplikácie na karte Ciferník identifikuje aplikáciu v obchode. Medzi verziami ho nemeňte. Ak chcete aktualizovať už zverejnenú aplikáciu, zadajte jej UUID.

Inštalácia súboru .prg do hodiniek

Pripojte hodinky k počítaču káblom USB a skopírujte súbor .prg do priečinka GARMIN/Apps v hodinkách. Po odpojení kábla sa ciferník zobrazí v zozname ciferníkov v hodinkách.

  • Windows: hodinky sa zobrazia v Prieskumníkovi ako zariadenie (napríklad "fēnix 7"). Otvorte Internal Storage → GARMIN → Apps a skopírujte tam súbor.
  • macOS: väčšina moderných hodiniek sa pripája cez MTP, ktoré macOS bez ďalšieho softvéru nepodporuje. Nainštalujte OpenMTP (zadarmo), pripojte hodinky, otvorte GARMIN/Apps a skopírujte tam súbor. Predtým zatvorte Garmin Express, inak prevezme pripojenie.
  • Linux: hodinky sa zobrazia v správcovi súborov (GNOME Files, Dolphin) ako zariadenie MTP; otvorte GARMIN/Apps a skopírujte tam súbor. Bez grafického prostredia možno hodinky pripojiť pomocou jmtpfs alebo simple-mtpfs.

Ak chcete ciferník odstrániť, vymažte súbor z GARMIN/Apps alebo ho odstráňte v hodinkách.

Poznámka: nastavenia ciferníka nainštalovaného týmto spôsobom nemožno zmeniť v aplikácii Garmin Connect, používa predvolené nastavenia. Ak chcete otestovať nastavenia, zverejnite ciferník v obchode ako beta aplikáciu.

Zverejnenie v Connect IQ Store

Návrhár nenahráva súbory do obchodu. Prihláste sa do panela vývojára Connect IQ (apps.garmin.com/developer), vytvorte aplikáciu typu "watch face", nahrajte súbor .iq, pridajte popis a snímky obrazovky a odošlite aplikáciu na kontrolu.

Ak chcete aplikáciu aktualizovať, zostavte nový súbor .iq (jeho verzia sa zvýši automaticky) a nahrajte ho ako novú verziu tej istej aplikácie. UUID a kľúč vývojára musia zostať rovnaké.

API

Prehľad

Rozhranie API PayToUse plní nasledujúce funkcie:

  1. Skontroluje stav aktivácie kódu na odomknutie a v prípade potreby ho aktivuje.
  2. Načíta údaje o hladine glukózy v krvi z aplikácie NightScout.
  3. Načíta aktuálne údaje o počasí pre zadanú lokalitu.

Všetky informácie je možné vyžiadať a vrátiť v rámci jednej požiadavky.

Koncové body API

Môžete použiť jeden z nasledujúcich koncových bodov:

  • https://api.pay-to-use.com
  • https://api.p2u.io

Oba koncové body spracúvajú požiadavky GET aj POST.

Parametre požiadavky

  • device: reťazec (povinné) — jedinečný identifikátor zariadenia
  • app: celé číslo (povinné) — ID vašej aplikácie
  • model: reťazec (voliteľné) — kód modelu zariadenia, potrebný na zber a zobrazenie štatistík o zariadeniach, ktoré používajú túto aplikáciu
  • code: reťazec (voliteľné) — kód na odomknutie
  • bg: asociatívne pole (voliteľné) — údaje potrebné na vyžiadanie hodnôt hladiny glukózy v krvi z aplikácie NightScout
    • url: reťazec (voliteľné) — adresa aplikácie NightScout
  • weather: asociatívne pole (voliteľné) — údaje potrebné na zistenie aktuálneho počasia
    • appid: reťazec (voliteľné) — prístupový kľúč k rozhraniu API pre počasie
    • lat: číslo s pohyblivou desatinnou čiarkou (voliteľné) — zemepisná šírka
    • lon: číslo s pohyblivou desatinnou čiarkou (voliteľné) — zemepisná dĺžka
    • provider: celé číslo (voliteľné) — poskytovateľ informácií o počasí

Zoznam podporovaných poskytovateľov meteorologických údajov

1. OpenWeatherMap

  • Popis: OpenWeatherMap poskytuje globálne meteorologické údaje, vrátane aktuálneho počasia, historických údajov a 16-dňových predpovedí. Vďaka širokému geografickému pokrytiu a častým aktualizáciám je OpenWeatherMap obľúbenou voľbou pre aplikácie, ktoré vyžadujú ako aktuálne informácie o počasí, tak aj dlhodobé predpovede.
  • Poskytnuté údaje: Teplota, vlhkosť, rýchlosť vetra, kvalita ovzdušia, pravdepodobnosť zrážok a ďalšie údaje v reálnom čase. Ponúka aktuálne údaje aj predpovede, vrátane minútových údajov o počasí pre vybrané lokality.
  • Výber poskytovateľa: V časti weather požiadavky uveďte provider = 1, aby ste ako poskytovateľa údajov o počasí vybrali OpenWeatherMap.
  • Pokyny na použitie: Ponúka bezplatnú aj platenú verziu, pričom k údajom je možné pristupovať prostredníctvom overenia pomocou API kľúča. V platených balíkoch sú k dispozícii pokročilé vrstvy údajov a prémiové funkcie.
  • One Call API 3.0: UV index je dostupný iba s kľúčom s predplatným One Call API 3.0 (samostatné predplatné vo vašom účte OpenWeatherMap). S takým kľúčom jedna požiadavka One Call nahrádza samostatné požiadavky na aktuálne počasie a predpoveď. Ak One Call kľúč odmietne, použije sa bezplatné API 2.5 a One Call sa skúsi znova po dni.
  • Dokumentácia API: K dispozícii tu.

2. QWeather

  • Popis: Služba QWeather, známa aj ako HeWeather, poskytuje komplexné údaje o počasí so zameraním na Čínu, obsahuje však aj údaje zo zahraničia. Ponúka podrobné informácie, ako sú aktuálne počasie, predpovede, informácie o kvalite ovzdušia a výstrahy.
  • Poskytnuté údaje: Aktuálna teplota, vlhkosť, UV index, úroveň znečistenia, denné a hodinové predpovede, ako aj varovania pred nepriaznivými poveternostnými podmienkami. Služba je známa podrobnými údajmi o kvalite ovzdušia a aktualizáciami v reálnom čase o meniacich sa poveternostných podmienkach.
  • Výber poskytovateľa: V časti weather požiadavky uveďte provider = 2, aby ste ako poskytovateľa údajov o počasí vybrali QWeather.
  • Pokyny na použitie: QWeather ponúka prístup cez API v bezplatnej a prémiovej verzii. Bezplatná verzia poskytuje obmedzené množstvo údajov, zatiaľ čo prémiové možnosti zahŕňajú ďalšie údaje a lokality.
  • Dokumentácia API: K dispozícii tu.

3. MET Weather (MET Norway)

  • Popis: Rozhranie MET Weather API, ktoré poskytuje organizácia MET Norway, ponúka prístup k širokej škále verejne dostupných meteorologických údajov, vrátane predpovedí, historických údajov a špecifických údajov pre Nórsko a severské regióny. Vďaka svojej presnosti a transparentnosti je MET Weather ideálnym riešením pre aplikácie, ktoré vyžadujú vysoko spoľahlivé meteorologické údaje.
  • Poskytnuté údaje: Aktuálne poveternostné podmienky, predpovede, zrážky, teplota, údaje o vetre a UV index. MET Weather ponúka špecializované údaje pre severské regióny, ale poskytuje aj globálne informácie o počasí.
  • Výber poskytovateľa: V časti weather požiadavky uveďte provider = 3, aby ste ako poskytovateľa údajov o počasí vybrali MET Weather.
  • Pokyny na použitie: Všetky údaje poskytované službou MET Weather sú voľne dostupné na použitie na základe licencie Creative Commons, ktorá bezplatne umožňuje ich využitie na nekomerčné aj komerčné účely. Organizácia MET Norway je známa svojimi environmentálnymi údajmi, vďaka čomu je dôveryhodným poskytovateľom najmä v Európe.
  • Dokumentácia API: K dispozícii tu.

Príklad požiadavky

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Skontroluje, či je zariadenie pripojené k telefónu na odoslanie požiadavky
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Overí, či bolo zariadeniu pridelené jedinečné identifikačné číslo
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // V prípade potreby odošle kód
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // V prípade potreby odošle URL aplikácie NightScout
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // V prípade potreby odošle parametre požiadavky na počasie
		var lat = Application.Properties.getValue("latitude");
		var lon = Application.Properties.getValue("longitude");
		if (!lat.equals("") && !lon.equals("")) {
			request.put("weather", {
				"appid" => Application.Properties.getValue("appID"),
				"lat" => lat,
				"lon" => lon,
				"provider" => wP
			});
		}
	}

	if (!request.isEmpty()) {

		// Vyplní požadované parametre požiadavky
		request.put("device", id);
		request.put("app", p2uAppID); // váš identifikátor aplikácie
		request.put("model", ds.partNumber);

		Toybox.Communications.makeWebRequest(
			"https://api.p2u.io", // Koncový bod API
			request,
			{
				:method => 3, // Communications.HTTP_REQUEST_METHOD_POST
				:headers => {
					"Content-Type" => 1 // Communications.REQUEST_CONTENT_TYPE_JSON
				},
				:responseType => 0 // Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
			},
			method(:onReceive)
		);
	}
}

Odpoveď API

Rozhranie API vráti objekt JSON s informáciami o stave odomknutia, hladine glukózy a počasí.

Parametre odpovede

Výsledky overenia kódu na odomknutie (ak bola odoslaná požiadavka):

  • response: celé číslo — návratový kód
  • msg: reťazec — správa o výsledku overenia
  • code: reťazec — kód na odomknutie, na ktorý sa výsledok vzťahuje, ak je známy
  • expires: celé číslo — časová pečiatka vypršania platnosti kódu vo formáte UNIXTIMESTAMP
  • qr: array — QR kód na nákup alebo overenie sériového čísla (ak je to potrebné)

Odpoveď aplikácie NightScout (ak bola odoslaná požiadavka):

  • bg: asociatívne pole — formátovaná odpoveď z aplikácie NightScout
    • value: celé číslo — hladina glukózy v krvi v mg/dl
    • date: celé číslo — časová pečiatka vypršania platnosti kódu vo formáte UNIXTIMESTAMP
    • direction: reťazec — trend zmien hladiny glukózy v krvi

Odpoveď rozhrania API pre počasie (ak bola odoslaná požiadavka):

  • weather: asociatívne pole — formátovaná odpoveď z rozhrania Weather API
    • provider: celé číslo — identifikátor poskytovateľa informácií o počasí
    • weather: array — aktuálne poveternostné podmienky. Môže vrátiť jednu alebo dve hodnoty; ak sa vrátia dve hodnoty, predstavujú denné a nočné podmienky
    • temp: číslo s pohyblivou desatinnou čiarkou — aktuálna teplota v stupňoch Celzia
    • feels_like: číslo s pohyblivou desatinnou čiarkou — pocitová teplota v stupňoch Celzia
    • pressure: celé číslo — atmosférický tlak v hPa
    • humidity: celé číslo — vlhkosť v %
    • precipitation: celé číslo — pravdepodobnosť zrážok v %
      Pri MET Weather iba v severských krajinách. -1, ak hodnota nie je dostupná.
    • wind: celé číslo — smer vetra v stupňoch
    • wind_speed: číslo s pohyblivou desatinnou čiarkou — rýchlosť vetra v m/s
    • wind_gust: číslo s pohyblivou desatinnou čiarkou — rýchlosť nárazov vetra v m/s
      Nedostupné pre QWeather. Pri MET Weather iba v severských krajinách. -1, ak hodnota nie je dostupná.
    • uvi: číslo s pohyblivou desatinnou čiarkou — UV index
      Pri OpenWeatherMap iba s kľúčom s predplatným One Call API 3.0. Pri QWeather denné maximum. Pri MET Weather UV index pri jasnej oblohe. -1, ak hodnota nie je dostupná.
    • temp_low: číslo s pohyblivou desatinnou čiarkou — dnešná najnižšia teplota v stupňoch Celzia
    • temp_high: číslo s pohyblivou desatinnou čiarkou — dnešná najvyššia teplota v stupňoch Celzia
    • sunrise_today: celé číslo — časový údaj dnešného východu slnka vo formáte UNIXTIMESTAMP
    • sunset_today: celé číslo — časový údaj dnešného západu slnka vo formáte UNIXTIMESTAMP
    • sunrise_tomorrow: celé číslo — časový údaj o zajtrajšom východe slnka vo formáte UNIXTIMESTAMP
    • sunset_tomorrow: celé číslo — časový údaj o zajtrajšom západe slnka vo formáte UNIXTIMESTAMP
    • aqi: asociatívne pole — index kvality ovzdušia
      • level: celé číslo — úroveň indexu kvality ovzdušia
      • value: celé číslo — hodnota indexu kvality ovzdušia

Príklad odpovede

https://api.p2u.io
{
	"response": 103,
	"msg": "Free for beta tester",
	"expires": 0,
	"qr": [
		"11111110111011010110101111111",
		"10000010111001001101001000001",
		"10111010101100110110101011101",
		"10111010110101000001001011101",
		"10111010000001010100001011101",
		"10000010100110001101001000001",
		"11111110101010101010101111111",
		"00000000010010110111100000000",
		"11001110000100100100100101111",
		"11111100011011011010011111111",
		"01111011100111111100101000001",
		"01111100101100110111011011011",
		"00110110101010100101110000010",
		"11001000010001011000001011111",
		"01101010001001110100000001101",
		"10111101100010100101100110011",
		"01010111111100110100100100010",
		"10000100111011011000101111011",
		"00000110110110110100100000101",
		"00111100011100001100101100011",
		"11110111110010100111111111001",
		"00000000111001011101100010001",
		"11111110010001011111101011101",
		"10000010100010100111100010010",
		"10111010101101100111111111001",
		"10111010010010110000010000001",
		"10111010001111111110000001111",
		"10000010111101011111101101011",
		"11111110100011011110110010010"
	],
	"bg": {
		"value": -102,
		"date": 1730546101,
		"direction": ""
	},
	"weather": {
		"provider": 1,
		"weather": [
			89
		],
		"temp": 0.27,
		"feels_like": -3.14,
		"pressure": 999,
		"humidity": 78,
		"precipitation": 0,
		"wind": 120,
		"wind_speed": 2.96,
		"wind_gust": 5.21,
		"uvi": 0.4,
		"temp_low": -3.8,
		"temp_high": 0.27,
		"sunrise_today": 1730527969,
		"sunset_today": 1730551770,
		"sunrise_tomorrow": 1730614492,
		"sunset_tomorrow": 1730638051,
		"aqi": {
			"level": 1,
			"value": 38
		}
	}
}

Kódy odpovede

Pole response výsledku overenia kódu na odomknutie nadobúda jednu z nasledujúcich hodnôt. Príklady odpovedí a poradie kontrol sú popísané v časti Kontroly na strane API.

Kód Popis
101Kód je platný. Aplikáciu je možné odomknúť.
102Žiadny platný kód, ale skúšobná doba ešte neuplynula. Aplikáciu je možné odomknúť do dátumu v poli expires.
103Žiadny platný kód, ale zariadenie je beta tester: jeho prvé volanie API prebehlo pred dátumom v poli Dátum vydania aplikácie. Aplikáciu je možné odomknúť do dátumu v poli expires (0 - bez obmedzenia).
201Kód sa nenašiel alebo bol odstránený.
202Kód je už aktivovaný na inom zariadení.
203Platnosť kódu vypršala.
204Skúšobná doba uplynula a nebol odoslaný platný kód.
301Aplikácia sa nenašla alebo nie je dostupná.
302Doba platnosti kódu nie je definovaná.
303Požiadavka neobsahuje dostatok parametrov.
304Pre túto aplikáciu je povinný identifikátor zariadenia.
401Chyba pri ukladaní kódu. Napíšte podpore na [email protected].
402Chyba pri ukladaní zariadenia. Napíšte podpore na [email protected].
500Neznáma chyba. Napíšte podpore na [email protected].

Kódy 1xx znamenajú, že aplikáciu je možné odomknúť, 2xx - že musí zostať zamknutá, 3xx - chybu v požiadavke, 4xx a 5xx - chybu na strane PayToUse. Pri chybách 4xx a 5xx sa odporúča ponechať posledný úspešný výsledok a požiadavku zopakovať neskôr.

Ak je v nastaveniach aplikácie zapnutá možnosť Povoliť opätovné odoslanie kódu podľa ID zariadenia, požiadavka obsahuje identifikátor zariadenia, ale neobsahuje kód, a k tomuto zariadeniu je už priradený platný kód, API vráti 101 spolu s týmto kódom v poli code. Aplikácia ho môže uložiť a už nežiadať používateľa o jeho zadanie.

Poznámky

  • Požiadavky s bg vyžadujú pripojenie k aplikácii NightScout.
  • Pri každej požiadavke obsahujúcej code API automaticky skontroluje stav kódu a v prípade, že je neaktívny, ho aktivuje.
  • Upozorňujeme, že parametre API sa môžu v priebehu času aktualizovať alebo upravovať s cieľom zlepšiť funkčnosť, kompatibilitu a bezpečnosť. Odporúčame pravidelne preverovať dokumentáciu API, či nedošlo k zmenám, ktoré by mohli ovplyvniť integráciu alebo používanie.

Poskytovatelia počasia

Nižšie je uvedená zhoda medzi poveternostnými podmienkami vracanými v poli weather a hodnotami jednotlivých poskytovateľov.

Garmin

Podrobný popis funkcií a konštánt súvisiacich s počasím v rámci Garmin SDK nájdete na tomto odkaze. V závislosti od zvoleného poskytovateľa informácií o počasí môžete ukladať hodnoty získané z API alebo výsledky funkcií Garmin SDK súvisiacich s počasím, aby ste zabezpečili konzistentnosť zobrazenia hodnôt na obrazovke.

ID Popis Deň Noc
0 Jasná obloha
0x53

0x54
40 Pekne
23 Prevažne jasno
0x55

0x56
1 Polooblačno
0x57

0x58
22 Čiastočne jasno
2 Prevažne oblačno
0x59
52 Riedke mraky
20 Zamračené
0x5A
45 Oblačno, možnosť dažďa
31 Mrholenie
0x3E
14 Slabý dážď
0x42
24 Slabé prehánky
3 Dážď
0x43
25 Prehánky
27 Možnosť prehánok
0x46
11 Ojedinelé prehánky
15 Silný dážď
26 Silné dažďové prehánky
28 Možnosť búrok
0x36

0x37
12 Ojedinelé búrky
0x38
6 Búrky
0x39
8 Hmla
0x4E
9 Opar
29 Riedka hmla
39 Zákal
30 Prach
0x4F
35 Piesok
33 Dym
38 Sopečný popol
37 Piesková búrka
13 Zrážky
5 Veterno
0x52
36 Víchrica
48 Snehové prehánky
32 Tornádo
0x50
41 Hurikán
42 Tropická búrka
50 Krúpky
0x45
7 Zimná zmes
18 Slabý dážď so snehom
19 Silný dážď a sneh
21 Dážď so snehom
49 Ľadový dážď
44 Pravdepodobnosť dažďa alebo snehu
47 Oblačno, možnosť dažďa alebo snehu
34 Ľad
51 Ľad a sneh
43 Možnosť sneženia
0x4C

0x4D
16 Slabé sneženie
46 Oblačno, možnosť sneženia
0x4A
4 Sneh
17 Silné sneženie
0x4B
10 Krupobitie
0x3A

Open Weather Map

Pozrite si napríklad sadu ikon pre OpenWeatherMap tu.

ID Popis Deň Noc
2xx Búrka
200 Búrka so slabým dažďom
0x36

0x37
201 Búrka s dažďom
0x38
202 Búrka s intenzívnym dažďom
210 Slabá búrka
211 Búrka
0x39
212 Silná búrka
0x3B
221 Nepravidelná búrka
230 Búrka so slabým mrholením
0x3A
231 Búrka s mrholením
232 Búrka so silným mrholením
3xx Mrholenie
300 Slabé mrholenie
0x3C

0x3D
301 Mrholenie
0x3E
302 Silné mrholenie
0x3F
310 Slabé mrholenie s dažďom
0x40
311 Mrholenie s dažďom
312 Silné mrholenie s dažďom
0x41
313 Prehánky a mrholenie
314 Silné prehánky a mrholenie
321 Mrholivé prehánky
5xx Dážď
500 Slabý dážď
0x42
501 Stredne silný dážď
0x43
502 Silný dážď
0x44
503 Veľmi silný dážď
504 Extrémny dážď
511 Ľadový dážď
0x45
520 Slabé dažďové prehánky
0x46
521 Dažďové prehánky
522 Silné dažďové prehánky
531 Nepravidelné dažďové prehánky
6xx Sneh
600 Slabé sneženie
0x4C

0x4D
601 Sneh
0x4A
602 Silné sneženie
611 Krúpky
0x45
612 Slabé prehánky dažďa so snehom
613 Prehánky dažďa so snehom
615 Slabý dážď so snehom
616 Dážď so snehom
620 Slabé snehové prehánky
0x4B
621 Snehové prehánky
622 Silné snehové prehánky
7xx Atmosféra
701 Riedka hmla
0x4E
711 Dym
0x4F
721 Zákal
731 Pieskové/prachové víry
741 Hmla
751 Piesok
0x4F
761 Prach
762 Sopečný popol
771 Húlavy
0x52
781 Tornádo
0x50
800 Jasná obloha
800 Jasná obloha
0x53

0x54
80x Oblačnosť
801 Malá oblačnosť 11–25 %
0x55

0x56
802 Polojasno 25–50 %
0x57

0x58
803 Oblačno 51–84 %
0x59
804 Zamračené 85–100 %
0x5A

QWeather

Pôvodnú sadu ikon počasia si môžete pozrieť kliknutím sem

ID Popis Deň Noc
302 Búrka s prehánkami
0x36

0x37
303 Silná búrka
0x38
310 Lejak
0x39
317 Lejak až silný lejak
304 Krupobitie
0x3A
311 Silný lejak
0x3B
312 Veľmi silný lejak
318 Silný až veľmi silný lejak
309 Mrholenie
0x3C

0x3D
404 Krúpky
0x3E
305 Slabý dážď
0x42
314 Slabý až mierny dážď
306 Mierny dážď
0x43
315 Mierny až silný dážď
399 Dážď
308 Extrémny dážď
0x44
316 Silný dážď až lejak
313 Ľadový dážď
0x45
405 Dážď a sneh
300 Dažďové prehánky
0x46
301 Silné dažďové prehánky
307 Silný dážď
350 Dažďové prehánky
351 Silné dažďové prehánky
400 Slabé sneženie
0x4C

0x4D
408 Slabé až mierne sneženie
499 Sneh
401 Mierne sneženie
0x4A
402 Silné sneženie
409 Mierne až silné sneženie
410 Silné sneženie až snehová búrka
403 Snehová búrka
0x4B
406 Prehánky dažďa so snehom
407 Snehové prehánky
456 Prehánky dažďa so snehom
457 Snehové prehánky
503 Piesok
0x4E
504 Prach
507 Prachová búrka
508 Piesková búrka
511 Mierny opar
512 Silný opar
513 Veľmi silný opar
500 Riedka hmla
0x4F
501 Hmla
502 Zákal
509 Hustá hmla
510 Silná hmla
514 Veľmi hustá hmla
515 Extrémne hustá hmla
100 Slnečno
0x53

0x54
150 Jasná obloha
101 Zamračené
0x55

0x56
151 Zamračené
102 Malá oblačnosť
0x57

0x58
152 Malá oblačnosť
103 Polojasno
0x59
153 Polojasno
104 Zamračené
0x5A

MET Weather

Pozrite si tu ako príklad sadu ikon pre MET Weather.

ID Popis Deň Noc
lightrainshowers Slabé dažďové prehánky
0x36

0x37
lightrainshowersandthunder Slabé dažďové prehánky a búrka
rainshowersandthunder Dažďové prehánky a búrka
heavyrainshowersandthunder Silné dažďové prehánky a búrka
heavyrainandthunder Silný dážď a búrka
0x38
rainandthunder Dážď a búrka
lightrainandthunder Slabý dážď a búrka
0x39
heavysleetandthunder Silný dážď so snehom a búrka
0x3B
lightsleetandthunder Slabý dážď so snehom a búrka
0x3A
lightssleetshowersandthunder Slabé prehánky dažďa so snehom a búrka
sleetandthunder Dážď so snehom a búrka
lightsleetshowers Slabé prehánky dažďa so snehom
0x3C

0x3D
sleetshowers Prehánky dažďa so snehom
sleetshowersandthunder Prehánky dažďa so snehom a búrka
heavysleetshowers Silné prehánky dažďa so snehom
heavysleetshowersandthunder Silné prehánky dažďa so snehom a búrka
lightsleet Slabý dážď so snehom
0x3E
sleet Krúpky
0x3F
heavysleet Silný dážď so snehom
0x45
lightrain Slabý dážď
0x42
rain Dážď
0x43
heavyrain Silný dážď
0x44
rainshowers Dažďové prehánky
0x46
heavyrainshowers Silné dažďové prehánky
heavysnow Silné sneženie
0x4B
heavysnowandthunder Silné sneženie a búrka
snow Sneh
snowandthunder Sneženie a búrka
lightsnowshowers Slabé snehové prehánky
0x4C

0x4D
lightssnowshowersandthunder Slabé snehové prehánky a búrka
snowshowers Snehové prehánky
snowshowersandthunder Snehové prehánky a búrka
heavysnowshowers Silné snehové prehánky
heavysnowshowersandthunder Silné snehové prehánky a búrka
lightsnow Slabé sneženie
0x4A
lightsnowandthunder Slabé sneženie a búrka
fog Hmla
0x4F
clearsky Jasná obloha
0x53

0x54
fair Pekne
0x55

0x56
partlycloudy Polooblačno
0x57

0x58
cloudy Zamračené
0x59