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:
- Vytvorenie a odoslanie požiadavky na overenie kódu
- Kontroly na strane API
- 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.
<properties>
<property id="UnlockCode" type="string"></property>
<property id="UnlockResult" type="string">Checking...</property>
...
<properties>
<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:
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:
|
| |
Trvalý kód:
| |
Dar:
| |
| 102 | |
| 103 | |
| 201 | |
| 202 | |
| 203 | |
| 204 | |
| 301 | |
| 302 | |
| 303 | |
| 304 | |
| 401 | |
| 402 | |
| 500 | |
Kontrola odpovede
Potom by ste mali skontrolovať odpoveď zo servera Pay-to-use API:
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:
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í:
- 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.
- E-mail - e-mail používateľa.
- Vytvorené - dátum vytvorenia: dátum alebo časová značka UNIXTIME. Ak je prázdne, použije sa dátum načítania.
- 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.
- 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:
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:
- Skontroluje stav aktivácie kódu na odomknutie a v prípade potreby ho aktivuje.
- Načíta údaje o hladine glukózy v krvi z aplikácie NightScout.
- 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
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
{
"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 |
|---|---|
| 101 | Kó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). |
| 201 | Kód sa nenašiel alebo bol odstránený. |
| 202 | Kód je už aktivovaný na inom zariadení. |
| 203 | Platnosť kódu vypršala. |
| 204 | Skúšobná doba uplynula a nebol odoslaný platný kód. |
| 301 | Aplikácia sa nenašla alebo nie je dostupná. |
| 302 | Doba platnosti kódu nie je definovaná. |
| 303 | Požiadavka neobsahuje dostatok parametrov. |
| 304 | Pre túto aplikáciu je povinný identifikátor zariadenia. |
| 401 | Chyba pri ukladaní kódu. Napíšte podpore na [email protected]. |
| 402 | Chyba pri ukladaní zariadenia. Napíšte podpore na [email protected]. |
| 500 | Nezná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 |
|