Handbuch
Einführung
Die Seitenleiste links enthält Links zum entsprechenden Abschnitt:
- Benutzername - Links zum persönlichen Profil.
- Übersicht - Den aktuellen Status in Form von Diagrammen und Grafiken anzeigen.
- Anwendungen - Anwendungsverwaltung.
- Freischaltcodes - automatisch generierte oder von Ihnen hochgeladene Freischaltcodes.
- Zahlungen - Verlauf der eingehenden Zahlungen der Benutzer.
- Handbuch - Das aktuelle Benutzerhandbuch.
Übersicht
Sie können gemeinsame Filter für alle Widgets im Dashboard festlegen:
- Währung - die Währung, in die eingehende und ausgehende Beträge im Dashboard umgerechnet werden.
- Zeitraum - ist der Zeitraum, für den Daten in den Diagrammen und Tabellen auf dem Dashboard angezeigt werden. Er bestimmt das Intervall, in dem Informationen und Statistiken zu Zahlungen, Anwendungen und anderen Parametern analysiert und angezeigt werden.
Kontostand
In diesem Bereich des Dashboards werden die wichtigsten Finanzkennzahlen angezeigt, die für Auszahlungen zur Verfügung stehen. Er enthält aggregierte Informationen zu allen Zahlungen der Nutzer unter Berücksichtigung der von den Zahlungssystemen und dem PayToUse-Dienst abgezogenen Gebühren.
In diesem Block werden folgende Beträge angezeigt:
- Brutto: Der Gesamtbetrag aller Nutzerzahlungen für den ausgewählten Zeitraum vor Abzug etwaiger Gebühren.
- Netto: Der Gesamtbetrag aller Zahlungen für den ausgewählten Zeitraum nach Abzug der Gebühren des Zahlungssystems und der PayToUse-Servicegebühren.
- Ausstehend: Der Nettobetrag aus Zahlungen, die noch nicht zur Auszahlung bereitstehen. Die Beträge stehen 7 Tage nach Zahlungseingang zur Auszahlung bereit.
- Verfügbar: Der Gesamtnettobetrag aller Zahlungen, die bereits auf Ihr Konto ausgezahlt werden können. Dies ist die wichtigste Kennzahl, die Ihr tatsächlich auszahlbares Guthaben widerspiegelt.
Test-Zahlungen sind von allen vier oben genannten Beträgen sowie vom Widget Zahlungen unten ausgeschlossen - sie enthalten niemals echtes Geld.
Auszahlen
Unterhalb der Anzeige des verfügbaren Betrags befindet sich die Schaltfläche „Auszahlen“. Über diese Schaltfläche können Sie eine Überweisung Ihrer Einnahmen beantragen.
Wenn Sie auf diese Schaltfläche klicken, öffnet sich ein Modalfenster, in dem Sie die Zahlungsdaten für die Überweisung angeben müssen.
Wichtiger Hinweis: Das System verwendet für die Auszahlung automatisch den gesamten verfügbaren Betrag, der im entsprechenden Feld angezeigt wird. Sie können keinen beliebigen Betrag angeben, der unter dem verfügbaren Guthaben liegt. Der Gesamtauszahlungsbetrag entspricht der Summe aller Zahlungen, die den Status „zur Auszahlung verfügbar“ haben.
Im Modalfenster können Sie den Betrag und die Währung für die Auszahlung auswählen. Die verfügbaren Währungen richten sich nach Ihren Zahlungsmethoden.
Hinweis: Wenn die ausgewählte Währung für die angegebene Auszahlungsmethode nicht unterstützt wird, wird der Auszahlungsantrag abgelehnt.
Weitere Informationen zu den Status und dem Verlauf Ihrer Auszahlungsanträge finden Sie im Abschnitt „Auszahlungen“.
Zahlungen
Das Zahlungs-Widget enthält eine Tabelle von Zahlungen, gruppiert nach Anwendung für den ausgewählten Zeitraum.
Tabellenfelder:
- Anwendung - Anwendung. In der Tabelle werden nur Anwendungen angezeigt, für die Zahlungen im ausgewählten Zeitraum erfolgt sind.
- Zahlungen - Anzahl der Zahlungen.
- Bruttobetrag - der Gesamtbetrag aller Zahlungen der Benutzer für den ausgewählten Zeitraum vor Abzug der Gebühren der Zahlungssysteme und von PayToUse.
- Nettobetrag - der Gesamtbetrag aller Zahlungen für den ausgewählten Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse.
Das Diagramm zeigt die Dynamik der Werte Nettobetrag und Bruttobetrag pro Tag.
Neue Benutzer
Das Diagramm der neuen Benutzer zeigt zwei Werte in der Dynamik pro Tag:
- Neue Benutzer - die Anzahl der neuen API-Aufrufe. API-Zugriffe werden nur aufgezeichnet, wenn der Parameter device - eine eindeutige Gerätekennung - übergeben wird, wenn eine Anfrage an die API gesendet wird. Dieser Parameter muss für das Gerät wirklich eindeutig sein. (siehe Senden einer Anfrage)
- Zahlungen - die Anzahl der Zahlungen für den gleichen Zeitraum pro Tag.
Konversion
Die Kennzahl „Konversion“ zeigt, wie effizient Neue Benutzer in Zahlungen umgewandelt werden.
Das Diagramm zeigt das Verhältnis der Anzahl von Zahlungen zur Anzahl von Neue Benutzer in Prozent.
Anwendungen
Wenn Sie diesen Abschnitt öffnen, öffnet sich eine Liste Ihrer Anwendungen.
Die Liste der Spalten in der Anwendungstabelle:
- # - Eindeutiger Anwendungsidentifikator. Wird beim Überprüfen des Anwendungscodes oder beim Anzeigen des Zahlungsformulars verwendet.
- Name - Anwendungsname. Der Name wird nur in Berichten und im Dashboard angezeigt. Durch Klicken auf den Anwendungsnamen wird die Bearbeitungsseite der Anwendung geöffnet.
- Status - der aktuelle Status der Anwendung. Er zeigt, wie weit der Einrichtungsassistent fortgeschritten ist. Er kann sein:
- Erstellt - die Anwendung wurde gerade erstellt, der Schritt Anwendung ist noch nicht abgeschlossen.
- Beschreibung - der Schritt Beschreibung ist noch nicht abgeschlossen.
- Preis - der Schritt Preis ist noch nicht abgeschlossen.
- Test - alle Einrichtungsschritte sind abgeschlossen, die Anwendung wurde jedoch noch nicht gestartet. Sie kann für Testzahlungen verwendet werden. Sie ist für Endnutzer nicht zugänglich.
- Starten - die Anwendung ist gestartet und akzeptiert echte Zahlungen.
- Erstellt - Das Datum der Anwendungserstellung.
- Zusätzliche Schaltflächen:
- Löschen - um die Anwendung aus der Liste zu entfernen.
Erstellen oder Bearbeiten einer Anwendung
Um Zahlungen zu akzeptieren, müssen Sie nacheinander alle erforderlichen Anwendungsdaten ausfüllen und die Anwendung aktivieren.
Die Schaltfläche zum Erstellen einer neuen Anwendung befindet sich in der Titelleiste der Anwendungsliste.
Anwendung
Felder, die beim Erstellen einer Anwendung verfügbar sind:
- Name - der Name der Anwendung, den nur Sie in Berichten oder im Dashboard sehen. Der Name wird im Seitenkopf der gespeicherten Anwendung angezeigt. Solange die Anwendung nicht gespeichert ist, wird anstelle des Namens „Neue App“ angezeigt. Pflichtfeld.
- Kontakt-E-Mail - die E-Mail-Adresse, an die Kopien der an Benutzer gesendeten Nachrichten geschickt werden. Diese Adresse wird auch im Feld „Reply-To“ angegeben; an sie antwortet der Benutzer auf die erhaltene E-Mail mit dem Code. Pflichtfeld. Standardmäßig wird der Wert aus dem Entwicklerprofil übernommen; er kann geändert werden.
- Anwendungstyp - Art der Anwendung:
- Einzeln - eine normale Anwendung mit eigenem Zahlungsformular und eigenen Freischaltcodes.
- Gruppe mit Schlüssel nur für eine App - ein Kauf für mehrere Anwendungen. Der Benutzer zahlt einmal im Zahlungsformular der Gruppe, und der Code kann in einer beliebigen Anwendung der Gruppe aktiviert werden. Nach der Aktivierung in einer Anwendung ist der Code in den anderen nicht mehr verfügbar.
- Gruppe mit Schlüssel für alle Apps - ein Kauf für mehrere Anwendungen. Der Benutzer zahlt einmal im Zahlungsformular der Gruppe und erhält einen Code, der in allen Anwendungen der Gruppe funktioniert. In jeder Anwendung wird der Code separat aktiviert und an das Gerät gebunden. Die Laufzeit des Codes ist gemeinsam: Sie wird ab der ersten Aktivierung in einer beliebigen Anwendung der Gruppe gezählt.
- Liste der Anwendungen der Gruppe - wird bei Gruppentypen angezeigt. Wählen Sie eine Anwendung in der Liste aus und klicken Sie auf Hinzufügen. Der Gruppe müssen mindestens zwei Anwendungen hinzugefügt werden. In der Liste sind nur Ihre Einzelanwendungen verfügbar, für die Freischaltcodes erzeugt werden. Für jede Anwendung der Gruppe wird eine Kopie des Gruppencodes erstellt, und in der Liste der Freischaltcodes werden diese Codes unter dem Gruppencode mit dem Status Unbekannt angezeigt.
- Feedback während der Zahlung aktivieren - fügt ein Feld zum Zahlungsformular hinzu, in dem Benutzer freien Text eingeben können. Feedback wird in die E-Mail-Kopie des Entwicklers aufgenommen. Feedback kann auch in den Zahlungsdetails eingesehen werden.
Änderungen werden beim Eingeben oder Ändern von Werten automatisch gespeichert - es gibt keine Schaltfläche „Speichern“. Eine Meldung erscheint nur, wenn etwas nicht gespeichert werden konnte. Sie können jederzeit zurückkehren und später Änderungen vornehmen.
Wechseln Sie zwischen den Schritten in der Kopfzeile der Seite - sie bleibt beim Scrollen oben. Der nächste Schritt wird verfügbar, sobald der aktuelle ausgefüllt ist; beim Öffnen wird der aktuelle Schritt gespeichert.
Beschreibung
Wählen Sie eine Sprache aus der Liste und klicken Sie auf Hinzufügen.
Ein Tab mit lokalisierten Anwendungstexten für die ausgewählte Sprache wird erscheinen.
Verfügbare Sprachen:
- Deutsch
- Englisch
- Französisch
- Spanisch
- Russisch
- Vereinfachtes Chinesisch
Die Felder in der Beschreibung werden verwendet, um Informationen im Zahlungsformular und in der Antwortnachricht an den Benutzer anzuzeigen:
- Lokalisierter Name - der Name der Anwendung für die ausgewählte Sprache. Er wird im Zahlungsformular und in der Zahlungsbenachrichtigungs-E-Mail angezeigt. Standardmäßig wird beim Hinzufügen einer Sprache der Anwendungsname eingefügt. Sie können für jede Sprache einen anderen Namen festlegen. Pflichtfeld.
- Anwendungsbeschreibung - eine kurze Beschreibung der Anwendung. Wird im Zahlungsformular unter dem Anwendungsnamen angezeigt. Optionales Feld. Sie können es leer lassen, wenn keine Beschreibung angezeigt werden soll.
- Nachricht zur Kaufbestätigung - zusätzliche Informationen, die dem Benutzer nach erfolgreicher Zahlung in der E-Mail gesendet werden. Der Antworttext wird am Ende der E-Mail nach der Standardantwort hinzugefügt.
Es muss mindestens eine Sprache hinzugefügt werden, um zu speichern und zur nächsten Seite zu gelangen.
Die Sprache des Zahlungsformulars wird automatisch anhand der Browsereinstellungen des Benutzers bestimmt. Markieren Sie eine der Sprachen mit dem Optionsfeld neben ihrem Tab (Tooltip Standard verwenden): Ihre Texte werden angezeigt, wenn die Sprache des Benutzers nicht unter den hinzugefügten ist.
Um eine Sprache zu entfernen, klicken Sie auf die Schaltfläche zum Löschen auf ihrem Tab und bestätigen Sie das Löschen.
Änderungen werden beim Eingeben oder Ändern von Werten automatisch gespeichert - es gibt keine Schaltfläche „Speichern“. Eine Meldung erscheint nur, wenn etwas nicht gespeichert werden konnte. Sie können jederzeit zurückkehren und später Änderungen vornehmen.
Wechseln Sie zwischen den Schritten in der Kopfzeile der Seite - sie bleibt beim Scrollen oben. Der nächste Schritt wird verfügbar, sobald der aktuelle ausgefüllt ist; beim Öffnen wird der aktuelle Schritt gespeichert.
Preis
Die Seite enthält eine Liste von Preisen und Feldern im Zusammenhang mit der Zahlung:
- Testzeitraum - die Dauer des Testzeitraums.
- Zeiteinheit - die Zeiteinheit des Testzeitraums. Wenn Sie zum Beispiel 7 Tage angeben, antwortet die API 7 Tage nach dem ersten API-Aufruf der Anwendung, dass der Testzeitraum abgelaufen ist. Der Zeitpunkt des ersten Geräteaufrufs wird gespeichert.
- Preisberechnungsmethode - Die Methode der Preiskalkulation aus der Liste:
- Preisberechnung abhängig von der Laufzeit - Im Zahlungsformular gibt der Benutzer den Aktivierungszeitraum des Codes an, und der Preis wird automatisch entsprechend der unten stehenden Tabelle berechnet. Der Benutzer erhält einen automatisch generierten Freischaltcode in der Antwort-E-Mail.
- Laufzeitberechnung abhängig vom Preis - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein, und der Zeitraum wird automatisch gemäß der unten stehenden Tabelle berechnet. Der Benutzer erhält einen automatisch generierten Code in der Antwortnachricht.
- Permanenter Code - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein. Nach der Zahlung erhält er einen Code aus der unten stehenden Liste, der dem ausgewählten Preis entspricht, in der Antwort-E-Mail.
- Spende - Im Zahlungsformular wählt der Benutzer einen Preis aus der Liste oder gibt seinen eigenen Preis ein. Für Anwendungen des Typs Spende wird kein Freischaltcode generiert.
- Temporärer Code mit Preis abhängig von der Laufzeit und Temporärer Code mit Laufzeit abhängig vom Preis - die Anwendung erhält von der API einen temporären Code für das Gerät und zeigt ihn dem Benutzer zusammen mit einem QR-Code an, der zum Zahlungsformular führt. Der Benutzer bezahlt diesen Code: Der Preis hängt von der gewählten Laufzeit ab oder die Laufzeit hängt vom bezahlten Preis ab, wie bei den obigen Methoden. Nach der Zahlung wird der Code nur für dieses Gerät aktiviert. Ein solcher Code kann nicht zurückgesetzt und auf ein anderes Gerät übertragen werden.
Für Gruppenanwendungen sind nur die Methoden Preisberechnung abhängig von der Laufzeit und Laufzeitberechnung abhängig vom Preis verfügbar. Bei der Methode Spende wird kein Testzeitraum verwendet.
Die Tabelle Preisliste legt die Preisstufen fest. Fügen Sie eine Zeile mit der Schaltfläche Hinzufügen hinzu und entfernen Sie sie mit der Schaltfläche Löschen. Die Spalten der Tabelle hängen von der Preisberechnungsmethode ab:
- Laufzeit, Preis - die Laufzeit des Codes (eine Zahl und eine Zeiteinheit: Tage, Monate, Jahre oder unbegrenzt) und sein Preis.
- Preis, Code - bei der Methode Permanenter Code: der Preis und der Code, den der Benutzer nach der Zahlung erhält (bis zu 12 Zeichen).
- Preis - bei der Methode Spende: nur die vorgeschlagenen Beträge.
Die mit dem Optionsfeld (Tooltip Standard verwenden) markierte Zeile ist im Zahlungsformular vorausgewählt.
Der Preis wird in US-Dollar festgelegt. Der Mindestpreis beträgt 1 US-Dollar.
Änderungen werden beim Eingeben oder Ändern von Werten automatisch gespeichert - es gibt keine Schaltfläche „Speichern“. Eine Meldung erscheint nur, wenn etwas nicht gespeichert werden konnte. Sie können jederzeit zurückkehren und später Änderungen vornehmen.
Wechseln Sie zwischen den Schritten in der Kopfzeile der Seite - sie bleibt beim Scrollen oben. Der nächste Schritt wird verfügbar, sobald der aktuelle ausgefüllt ist; beim Öffnen wird der aktuelle Schritt gespeichert.
Vorschau
Auf dieser Seite werden folgende Werte festgelegt:
- Codelänge - die Länge des generierten Codes, falls zutreffend.
- Zeichensatz für Code - der Zeichensatz, aus dem der Code generiert wird:
- Numerischer Code - der Code wird nur mit den Ziffern 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 generiert. Führende Nullen können im Code enthalten sein. Führende Nullen sind bei der Überprüfung des Codes von Bedeutung.
- Alphanumerischer Code - der Code wird mit den Zeichen 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 generiert. Der Code wird dem Benutzer in Großbuchstaben generiert und gesendet. Die Groß- und Kleinschreibung der Zeichen ist bei der Überprüfung des Codes unerheblich.
- Führende Nullen im Code erlauben - erlaubt führende Nullen im generierten Code. Nur verfügbar für den Zeichensatz Numerischer Code.
- Erneutes Senden des Codes per Geräte-ID erlauben - ermöglicht das erneute Senden des Codes an dieselbe E-Mail-Adresse durch Wiederholung der Geräte-ID-Prüfung. Nur für Einzelanwendungen verfügbar.
- Zifferblatt-Designer - die App ist ein im Designer erstelltes Zifferblatt: Dieser Schritt zeigt den Designer statt des Zahlungslinks und der Codebeispiele. Für Zifferblätter, die auf der Startseite erstellt wurden, eingeschaltet.
- Veröffentlichungsdatum - das Datum, ab dem die Anwendung für reguläre Nutzer verfügbar ist. Zusammen mit Kostenlos für Beta-Tester nach der Veröffentlichung definiert es einen kostenlosen Zeitraum für Geräte, die die Anwendung vor diesem Datum kontaktieren.
- Kostenlos für Beta-Tester nach der Veröffentlichung - die Länge des kostenlosen Zeitraums (in der gewählten Zeiteinheit), der Geräten gewährt wird, deren erster API-Aufruf vor dem Veröffentlichungsdatum erfolgte. Für solche Geräte erstellte Codes erhalten den Status Unbekannt.
- Link zur Codeprüfung - ein Beispiel-Link zur Verwendung für die Code-Überprüfung.
- Link zum Bezahlen - Zahlungslink. Sie können den Link kopieren und in die Beschreibung der Anwendung auf der Website einfügen, auf der die Anwendung veröffentlicht ist. Für jede Domain (https://pay-to-use.com für alle Sprachen, https://pay-to-use.ru nur für die russische Sprache) wird ein separater Link und QR-Code generiert, verfügbar als Tabs über dem Linkfeld. Zu übergebende Parameter:
- app - der eindeutige Bezeichner der Anwendung. Erforderlicher Parameter.
- amount - der Betrag, der beim Kauf im Preisfeld angegeben wird. Der Standardpreis wird ignoriert. Der Betrag kann jedoch nicht weniger als der Mindestpreis und nicht niedriger als der für die Anwendung festgelegte Mindestpreis sein. Optionaler Parameter.
Der Link Link zum Bezahlen wird erst öffentlich zugänglich, sobald die Anwendung gestartet ist. Verwenden Sie vorher die Schaltfläche Testzahlung unten, um das Zahlungsformular mit einem signierten, temporären Zugriffstoken zu öffnen - dasselbe Formular und dieselben Zahlungsmethoden wie im echten Fall, aber es wird kein Geld abgebucht: Eine Zahlung wird direkt mit dem Status Test erstellt, und ein voll funktionsfähiger Code (falls zutreffend) wird sofort generiert und per E-Mail versendet, ohne das Zahlungssystem zu durchlaufen. Testzahlungen sind in der Liste Zahlungen sichtbar, mit dem Status Test markiert, werden aber von den Kontostand-Gesamtsummen ausgeschlossen.
Die Schaltfläche Testzahlung öffnet ein Dropdown-Menü zur Auswahl der Domain (https://pay-to-use.com oder https://pay-to-use.ru), auf der das Testzahlungsformular geöffnet wird - beide sind gleichermaßen funktionsfähig, die Wahl ist nur relevant, wenn Sie gebietsspezifisches Verhalten testen möchten.
Um echte Zahlungen anzunehmen, schalten Sie Testmodus aus. Stellen Sie vorher sicher, dass alle eingegebenen Daten korrekt sind. Die von der Anwendung generierten Schlüssel können nicht geändert werden. Solange der Testmodus aktiv ist, wird neben dem Anwendungsnamen das Abzeichen Test angezeigt. Wenn Sie Testmodus wieder einschalten (nach einer Bestätigung), werden keine echten Zahlungen mehr angenommen und die Schaltfläche Testzahlung ist wieder verfügbar.
Codeüberprüfung
Die Überprüfung des Freischaltcodes der Anwendung erfolgt in 3 Schritten:
- Erstellen und Senden einer Anfrage zur Code-Überprüfung
- Überprüfungen auf der API-Seite
- Empfang und Verarbeitung der API-Antwort
Senden einer Anfrage
Um den Code zu überprüfen, muss der Benutzer Ihrer Anwendung diesen in das Feld in den Anwendungseinstellungen eingeben.
<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>
Dann müssen Sie eine Anfrage an den Pay-to-use API-Server senden:
function onTemporalEvent() as Void {
var ds = System.getDeviceSettings();
return Toybox.Communications.makeWebRequest(
"https://api.pay-to-use.com", // API-URL
{
"device" => ds.uniqueIdentifier, // eindeutige Gerätekennung
"app" => "6", // Ihre Anwendungs-ID
"model" => ds.partNumber, // Geräte-Teilenummer
"code" => Application.Properties.getValue("UnlockCode") // Freischaltcode-Wert in Ihrer Anwendung
},
{
:method => Communications.HTTP_REQUEST_METHOD_POST,
:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
},
method(:onReceive)
);
}
API-Anfrageparameter:
- url - https://api.pay-to-use.com. Die Verwendung von HTTPS ist obligatorisch.
- Der Inhalt der Anfrage (die übergebenen Werte). Ein Wörterbuch aus Schlüsseln und Werten:
- device - eindeutiger Bezeichner des Geräts.
- app - eindeutiger Bezeichner Ihrer Anwendung.
- model – Gerätemodellkennung. Optionaler Parameter. Die Daten werden zur Anzeige von Statistiken für neue Geräte verwendet.
- code - vom Benutzer in den Anwendungseinstellungen eingegebener Freischaltcode.
- Anfrageoptionen:
- :method - die API unterstützt die Anfrage-Methoden GET und POST.
- :headers - bei der POST-Methode müssen Parameter im JSON-Format übergeben werden.
- :responseType - die Antwort wird im JSON-Format zurückgegeben.
- responseCallback - ein Link zur Callback-Methode, die zwei Argumente akzeptieren sollte:
- responseCode - der Antwortheader-Code des Servers.
- data - der Inhalt, falls die Anfrage erfolgreich war, oder null.
Überprüfungen auf der API-Seite
Wenn keine Parameter an die API übergeben werden, gibt die API einen HTTP/1.1 404 Not Found-Header zurück.
Wenn mindestens ein Parameter an die API übergeben wird, gibt die API den Header HTTP/1.1 200 OK zurück.
Die Serverantwort besteht aus:
- response - Antwortcode
- msg - Textbeschreibung der Antwort
- expires - UNIXTIME-Zeitstempel (falls zutreffend)
Es wird überprüft, ob die übergebene Anwendungs-ID korrekt ist. Die Anwendung muss zum Zeitpunkt der Zahlung den Status Veröffentlicht haben. Im Fehlerfall wird der Antwortcode 301 zurückgegeben.
Wenn eine eindeutige Geräte-ID übertragen wird, wird die Geräte-ID gesucht und gespeichert. Wenn beim Überprüfen oder Speichern Fehler auftreten, wird der Fehlercode 402 zurückgegeben. Wenn Sie einen solchen Rückgabecode erhalten, schreiben Sie sofort an den Support unter [email protected]
Wenn der Code übergeben wird, werden die folgenden Schritte für Anwendungen mit den Berechnungsmethoden Preisberechnung abhängig von der Laufzeit und Laufzeitberechnung abhängig vom Preis ausgeführt:
- Wenn ein leerer Code übertragen wird, wird er von der in den vorherigen Schritten ermittelten eindeutigen Gerätekennung getrennt.
- Wenn ein nicht leerer Code übertragen wird und er nicht aktiviert ist, wird der Code abhängig von den Bedingungen des bei Kauf angegebenen Preises aktiviert, unabhängig vom Aktivierungsdatum.
- Wenn kein Code übertragen wurde oder der übertragene Code nicht gefunden wurde, wird der Fehlercode 201 zurückgegeben.
- Der aktivierte Code wird mit dem Gerät abgeglichen, und wenn bei der Aktivierung eine andere eindeutige Gerätekennung als die gespeicherte übermittelt wurde, wird der Fehlercode 202 zurückgegeben.
- Wenn der übermittelte Code kein Ablaufdatum hat und alle vorherigen Überprüfungen bestanden wurden, wird der Code 101 zurückgegeben.
- Wenn der Code zeitlich begrenzt ist, wird eine Überprüfung durchgeführt. Wenn der Schlüssel nicht abgelaufen ist, wird der Code 101 zurückgegeben. Wenn der Code abgelaufen ist, wird der Fehlercode 203 zurückgegeben.
- Diese Art von Anwendung erfordert, dass der Code an das Gerät gebunden ist. Wenn die eindeutige Geräte-ID nicht übermittelt wurde, wird der Fehlercode 304 zurückgegeben.
Für eine Anwendung mit einem Permanenter Code wird nur die Verfügbarkeit des Codes zum Zeitpunkt des Kaufs überprüft. Wenn ein Code gefunden wird, wird der Code 101 zurückgegeben. Wenn kein Code gefunden wird, wird der Fehlercode 201 zurückgegeben.
Für eine Anwendung mit der Berechnungsmethode Spende wird der Code nicht überprüft. Der Code 101 wird immer zurückgegeben.
Wenn ein leerer Code übermittelt wird und bei der Anwendung das Feld Veröffentlichungsdatum ausgefüllt ist, wird der Betatester-Zeitraum geprüft: Wenn das Gerät die API erstmals vor dem Veröffentlichungsdatum kontaktiert hat und der Zeitraum Kostenlos für Beta-Tester nach der Veröffentlichung noch nicht abgelaufen ist, wird der Code 103 zurückgegeben.
Wenn die Option Erneutes Senden des Codes per Geräte-ID erlauben aktiviert ist und kein Code übermittelt wird, wird nach einem gültigen Code gesucht, der bereits dem Gerät zugeordnet ist. Wird er gefunden, wird der Code 101 zusammen mit dem Code selbst zurückgegeben.
Wenn die vorherigen Überprüfungen nicht bestanden wurden, wird der Testzeitraum überprüft. Wenn seit dem ersten Kontakt des Geräts mehr Zeit vergangen ist als in den aktuellen Anwendungseinstellungen angegeben, wird der Fehlercode 204 zurückgegeben. Wenn die Testphase noch nicht abgelaufen ist, wird der Fehlercode 102 zurückgegeben.
Wenn nur die Anwendungs-ID übermittelt wird und weder der Freischaltcode noch die eindeutige Geräte-ID übermittelt werden, wird der Fehlercode 303 zurückgegeben.
Wenn die zurückgegebene Antwort 500 lautet, sollten Sie sich an den Support unter [email protected] wenden
Im Folgenden finden Sie eine Tabelle aller zurückgegebenen Codes:
| Code | Nachricht |
|---|---|
| 101 |
Berechnungsmethoden Preisberechnung abhängig von der Laufzeit und Laufzeitberechnung abhängig vom Preis:
|
| |
Permanenter Code:
| |
Spende:
| |
| 102 | |
| 103 | |
| 201 | |
| 202 | |
| 203 | |
| 204 | |
| 301 | |
| 302 | |
| 303 | |
| 304 | |
| 401 | |
| 402 | |
| 500 | |
Überprüfen der Antwort
Dann sollten Sie die Antwort vom Pay-to-use API-Server überprüfen:
function onReceive(responseHeader, data) as Void {
if (responseHeader == 200) { Toybox.Background.exit(data); }
}
Sie können alle Header und Codes überprüfen, Sie können Ihre eigenen Nachrichten zur Benutzerfreundlichkeit anzeigen, aber in der einfachsten Form sieht die Überprüfung etwa so aus:
function onBackgroundData(data) as Void {
if (data.hasKey("response")) {
if (data.hasKey("msg")) {
// Sie können data["msg"] im Eigenschaftsfeld mit dem Namen "UnlockResult" anzeigen.
Application.Properties.setValue("UnlockResult", data["msg"]);
}
if (data["response"].toString().substring(0, 1).equals("2")) {
// Code-Überprüfung fehlgeschlagen
// Bezahlte Funktionen sind NICHT verfügbar
...
} else {
// Die Code-Überprüfung war erfolgreich oder der Fehler liegt bei Ihnen oder bei der API
// Bezahlte Funktionen sind verfügbar
...
}
}
}Freischaltcodes
Wenn Sie diesen Abschnitt öffnen, wird eine Liste der Freischaltcodes geöffnet.
Liste der Freischaltcodes
Sie können in der oberen Suchleiste nach E-Mail oder Code suchen. Die gefundenen Codes werden in der Liste angezeigt. Sie können die gesamte E-Mail-Adresse oder den Code oder Teile davon als Suchkriterium verwenden. Übereinstimmungen werden farblich hervorgehoben. Suche und Filter funktionieren gleichzeitig und schließen sich nicht gegenseitig aus.
Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das bedeutet, dass beim nächsten Mal, wenn Sie die Seite betreten, der zuletzt verwendete Filter automatisch angewendet wird. Filter sind für die Liste der Freischaltcodes verfügbar:
- Spalten - Wählen Sie Tabellenspalten aus, die in der Liste der Freischaltcodes angezeigt werden sollen.
- Anwendung - Zeigen Sie nur Freischaltcodes für ausgewählte Anwendungen an.
- Status - Zeigen Sie nur Freischaltcodes an, die sich in den ausgewählten Status befinden.
Die Liste der Spalten in der Tabelle der Freischaltcodes:
- Anwendung - Ihre Anwendung. Sie können dem Link folgen, um ihre Einstellungen zu bearbeiten.
- Code - der Freischaltcode.
- E-Mail - die mit der Registrierung des Freischaltcodes verbundene E-Mail-Adresse. Diese Adresse wird verwendet, um Client-Freischaltcodes im Abschnitt Meine Käufe der Website zu suchen. Dieser Abschnitt ist für Benutzer zugänglich.
- Laufzeit - die Gültigkeitsdauer des gesendeten Codes (angegeben in den Anwendungseinstellungen). Für den Code wird eine Gültigkeitsdauer festgelegt, die den Bedingungen der Anwendungseinstellungen zum Zeitpunkt seiner Erstellung entspricht.
- Status - der Status des Freischaltcodes. (siehe Freischaltcode-Status)
- Erstellt - das Erstellungsdatum des Freischaltcodes.
- Sprache - die Sprache des Benutzers, die für Nachrichten mit dem Code verwendet wird.
- Aktivierung - das Aktivierungsdatum des Codes. Es wird festgelegt, wenn dieses bestimmte Benutzergerät zum ersten Mal den PayToUse-API-Dienst kontaktiert und diesen Code übermittelt. Der Status des Codes ändert sich zu Aktiviert. Nur ein inaktiver Code kann aktiviert werden. Wenn ein aktiver Code von einem Gerät mit einer anderen ID übermittelt wird, gibt die API den Fehler 202 zurück. Nur ein Gerät kann mit einem einzigen Code verknüpft werden.
- Ablauf - das Datum, an dem die Codeaktivierung abläuft. Wird für Codes gesetzt, die eine begrenzte Gültigkeitsdauer bei der Codeaktivierung haben. Für Codes mit unbegrenztem Ablaufdatum bleibt dieses Feld leer.
- Gelöscht - das Löschdatum des Codes. Beim Löschen wird der Codestatus auf Unbekannt gesetzt.
- Gerät - die eindeutige Kennung des Geräts, an das der Code gebunden ist.
- Erster Gerätezugriff - das Datum des ersten API-Aufrufs des Geräts. Ab diesem Datum werden der Testzeitraum und der Betatester-Zeitraum gezählt.
- Letzter Gerätezugriff - das Datum des letzten API-Aufrufs des Geräts. Damit können Sie prüfen, ob die Anwendung noch verwendet wird.
- Zahlung # - eindeutige Sequenznummer der Zahlung. Sie können auf den Link klicken, um die Details der Zahlung anzuzeigen.
- Notizen - Notizen, die bei der manuellen Erstellung der Codes eingegeben wurden.
- Schaltflächen für Aktionen mit Freischaltcodes. Zum Beispiel Löschen.
Freischaltcode-Status
Während seines Lebenszyklus durchläuft der Freischaltcode verschiedene Zustände, die über den Code-Status verfolgt werden können.
| Status | Beschreibung |
|---|---|
| Verfügbar | Der Status wird einem Freischaltcode zugewiesen, für den keine Aktionen durchgeführt wurden oder wenn die Geräteverknüpfung für den Code zurückgesetzt wurde. |
| Aktiviert | Der Status wird für einen Code mit festgelegtem Aktivierungsdatum gesetzt. Das Aktivierungsdatum wird festgelegt, wenn das Gerät zum ersten Mal erfolgreich auf den PayToUse-API-Dienst zugreift. Bei der Aktivierung des Codes wird außerdem sein Ablaufdatum festgelegt. |
| Abgelaufen | Der Status wird für einen abgelaufenen Code festgelegt. Das Trennen des Codes vom Gerät setzt das Ablaufdatum des Codes nicht zurück. Das Überprüfen des Codes mit diesem Status wird den Fehler 203 zurückgeben. (siehe Überprüfungen auf der API-Seite) |
| Unbekannt | Der Status wird gesetzt, wenn der Code gelöscht wird. Das Überprüfen des Codes mit diesem Status wird den Fehler 201 zurückgeben. (siehe Überprüfungen auf der API-Seite) |
| Unbekannt | Der Status wird für einen Code festgelegt, der für ein Gerät erstellt wurde, dessen erster API-Aufruf vor dem Veröffentlichungsdatum der Anwendung erfolgte - ihm wird ein kostenloser Zeitraum anstelle der üblichen Testphase oder kostenpflichtigen Aktivierung gewährt, wie durch Kostenlos für Beta-Tester nach der Veröffentlichung konfiguriert. |
| Unbekannt | Der Status wird für einen Code festgelegt, der von mehreren gruppierten Anwendungen gemeinsam genutzt wird. Er ist nicht an eine einzelne Anwendung gebunden und erscheint nicht in der Codeliste der einzelnen Anwendungen der Gruppe. |
| Unbekannt | Wie Unbekannt, aber der Code ist nicht mehr verfügbar: Er wurde gelöscht oder, bei einer Gruppe mit einem Schlüssel für nur eine Anwendung, bereits in einer der Anwendungen der Gruppe aktiviert. Beim Löschen des Gruppencodes werden auch seine Kopien in allen Anwendungen der Gruppe gelöscht. |
| Unbekannt | Der Status wird für einen Code einer Anwendung innerhalb einer Gruppe festgelegt, wenn er einzeln gelöscht wird, während der Gruppencode selbst bestehen bleibt. |
Code-Details
Ein Klick auf den Code in der Liste öffnet die Detailseite des Codes. Sie zeigt dieselben Felder wie die Liste und Schaltflächen für Aktionen mit dem Code:
- Zurücksetzen - löst den Code vom Gerät und setzt das Aktivierungsdatum zurück. Der Status des Codes ändert sich in Verfügbar, und der Code kann auf einem anderen Gerät aktiviert werden, zum Beispiel wenn der Benutzer das Gerät gewechselt hat. Das Ablaufdatum eines bereits aktivierten Codes wird nicht zurückgesetzt. Die Schaltfläche ist für Anwendungen mit temporären Codes nicht verfügbar, da ein solcher Code nur auf einem Gerät verwendet werden kann.
- Aktivieren - verfügbar für einen temporären Code, der noch nicht bezahlt wurde. Geben Sie die E-Mail des Benutzers und die Laufzeit des Codes ein: Der Code wird für das Gerät aktiviert, an das er gebunden ist, als ob er bezahlt worden wäre. Verwenden Sie dies zum Beispiel, um dem Benutzer die Anwendung kostenlos zu überlassen.
- Code senden - sendet eine E-Mail mit dem Code und seinen Details an die E-Mail des Codes. Wählen Sie die Sprache der Nachricht. Wenn Kopie an den Entwickler senden markiert ist, wird eine Kopie der E-Mail an die Kontakt-E-Mail der Anwendung gesendet. Verwenden Sie dies, wenn der Benutzer die E-Mail mit dem Code verloren hat.
- E-Mail ändern - ändert die E-Mail des Codes. Bei einem Gruppencode wird die E-Mail für den Gruppencode und alle seine Kopien geändert. Wenn der Code durch eine Zahlung erhalten wurde, wird auch die E-Mail der Zahlung geändert. Der Benutzer findet den Code dann im Bereich Meine Käufe unter der neuen E-Mail.
- Löschen - löscht den Code. Der Status des Codes ändert sich in Unbekannt, und die Prüfung des Codes gibt den Fehler 201 zurück. Ein unbezahlter temporärer Code wird vollständig gelöscht.
Aktionen mit dem Code sind auch auf der Detailseite der Zahlung verfügbar, wenn für die Zahlung ein Code gesendet wurde.
Erstellen
Die Schaltfläche Erstellen in der Titelleiste der Liste der Freischaltcodes öffnet das Formular zum Erstellen von Codes ohne Zahlung. Zum Beispiel für Betatester, Rezensenten oder Benutzer, die auf andere Weise bezahlt haben. Felder des Formulars:
- E-Mail - die Adresse, an die die erstellten Codes gesendet werden. Eine Kopie der E-Mail wird an die Kontakt-E-Mail der Anwendung gesendet.
- Anwendung - die Anwendung, für die die Codes erstellt werden. Es sind nur Anwendungen in den Status Test und Starten mit der Preisberechnungsmethode Preisberechnung abhängig von der Laufzeit oder Laufzeitberechnung abhängig vom Preis verfügbar.
- Laufzeit und Zeiteinheit - die Gültigkeitsdauer der Codes. Sie wird ab der Aktivierung des Codes auf dem Gerät gezählt.
- Anzahl - die Anzahl der zu erstellenden Codes.
- Notizen - beliebiger Text, der mit den Codes gespeichert wird. Wird in der Spalte Notizen der Liste angezeigt.
- Notizen in die E-Mail aufnehmen - fügt die Notizen der E-Mail mit den Codes hinzu.
Die Codes werden gemäß den Code-Einstellungen der Anwendung (Länge und Zeichensatz) erzeugt. Nach dem Speichern wird die Liste der erstellten Codes angezeigt und die E-Mail gesendet.
Hochladen
Mit der Schaltfläche Hochladen können Sie Codes laden, die außerhalb von PayToUse ausgegeben wurden, zum Beispiel beim Umstieg von einem anderen Lizenzsystem. Wählen Sie die Anwendung, die Datei und die Dateiparameter:
- Dateiformat - CSV, Zeichenkodierung UTF-8. Die maximale Dateigröße wird im Upload-Formular angezeigt.
- enthält Kopfzeilen - markieren Sie dies, wenn die erste Zeile der Datei Spaltennamen enthält. Die erste Zeile wird dann übersprungen.
- Trennzeichen - Semikolon, Komma oder Tabulator.
Spalten der Datei in dieser Reihenfolge:
- Code - der Freischaltcode, erforderlich. Wird in Großbuchstaben umgewandelt und auf 12 Zeichen gekürzt. Codes, die für die Anwendung bereits existieren, werden übersprungen.
- E-Mail - die E-Mail des Benutzers.
- Erstellt - das Erstellungsdatum: ein Datum oder ein UNIXTIME-Zeitstempel. Wenn leer, wird das Upload-Datum verwendet.
- Ablauf - das Ablaufdatum: ein Datum oder ein UNIXTIME-Zeitstempel. Leer lassen, wenn der Code noch nicht aktiviert wurde oder kein Ablaufdatum hat.
- Laufzeit - die Gültigkeitsdauer nach der Aktivierung: eine Zahl und eine Einheit, zum Beispiel 12h, 30d, 6m oder 1y. Wenn leer, ist der Code unbegrenzt gültig.
Nach dem Hochladen wird die Tabelle der geladenen Zeilen angezeigt. Nicht geladene Zeilen sind rot hervorgehoben, und eine Meldung zeigt, wie viele Zeilen von der Gesamtzahl eingefügt wurden. Beim Hochladen werden keine E-Mails an Benutzer gesendet.
Herunterladen
Die Schaltfläche Herunterladen lädt die Liste der Freischaltcodes als CSV-Datei herunter. Wählen Sie im Formular die Felder aus, die in die Datei aufgenommen werden sollen. Die Datei enthält alle Codes, die den aktuellen Filtern und der Suche entsprechen, nicht nur die Codes der aktuellen Seite. Die ausgewählten Felder werden für den nächsten Download gespeichert.
Zahlungen
Wenn Sie diesen Abschnitt öffnen, wird eine Liste der Benutzerzahlungen angezeigt.
Die folgenden Zahlungssysteme werden zum Empfangen von Zahlungen verwendet:
Nach den Gebühren des Zahlungssystems berechnet PayToUse eine Gebühr von 13%. Wir arbeiten ständig daran, die Gebühren zu reduzieren.
Wenn es im Zahlungssystem zu Streitfällen oder Rückerstattungen kommt, werden die Gebühren des Zahlungssystems an den Entwickler weitergegeben. Daher sollten Sie solche Situationen vermeiden. In Streitfällen wird keine PayToUse-Gebühr berechnet.
Liste der Zahlungen
Sie können in der oberen Suchleiste nach E-Mail oder gesendetem Code suchen. Die gefundenen Zahlungen werden in der Liste angezeigt. Sie können die gesamte E-Mail-Adresse oder den Code oder Teile davon als Suchkriterium verwenden. Übereinstimmungen werden farblich hervorgehoben. Suche und Filter funktionieren gleichzeitig und schließen sich nicht gegenseitig aus.
Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das bedeutet, dass beim nächsten Mal, wenn Sie die Seite betreten, der zuletzt verwendete Filter automatisch angewendet wird. Filter stehen für die Liste der Zahlungen zur Verfügung:
- Spalten - Wählen Sie Tabellenspalten aus, die in der Zahlungsliste angezeigt werden sollen.
- Zeitraum - nur Zahlungen anzeigen, die im ausgewählten Datumsbereich erstellt wurden.
- Anwendung - Zeigt Zahlungen nur für ausgewählte Anwendungen an.
- System - Zeigt Zahlungen nur von ausgewählten Zahlungssystemen an.
- Status - Zeigt Zahlungen nur mit ausgewählten Status an.
Die Liste der Spalten in der Zahlungstabelle:
- Anwendung - Ihre Anwendung. Sie können dem Link folgen, um ihre Einstellungen zu bearbeiten.
- # - Eindeutige Sequenznummer der Zahlung. Sie wird der Zahlung automatisch zugewiesen, wenn der Benutzer vom Zahlungsformular zur Zahlungsseite im Zahlungssystem wechselt. Sie können auf den Link klicken, um die Details der Zahlung anzuzeigen.
- Kommentare - Nachricht des Benutzers, die im Zahlungsformular eingegeben wurde.
- System - das vom Benutzer ausgewählte Zahlungssystem.
- Status - der Zahlungsstatus. (siehe Zahlungsstatus)
- E-Mail - E-Mail-Adresse des Benutzers, die im Zahlungsformular angegeben wurde.
- Laufzeit - Gültigkeitsdauer des gesendeten Codes (in den Anwendungseinstellungen angegeben).
- Sprache - die vom Benutzer gewählte Sprache des Zahlungsformulars.
- Erstellt - das Erstellungsdatum der Zahlung.
- Rechnungsbetrag - der Betrag der Zahlung, der dem Benutzer belastet wurde. Wird im Zahlungsformular entsprechend den Anwendungseinstellungen angegeben.
- Zahlungsdatum - das Zahlungsdatum.
- Zahlungsbetrag - der Betrag der Zahlung, der vom Zahlungssystem bestätigt wurde.
- Gesendeter Code - Code, der an den Benutzer gesendet wurde.
- Verfügbarer Betrag - verfügbarer Auszahlungsbetrag.
- Auszahlungsbetrag - der für die Zahlung ausgezahlte Betrag.
Zahlungsdetails
Ein Klick auf die # einer Zahlung in der Liste öffnet deren Detailseite.
Zusätzlich zu den oben bereits aufgeführten Feldern zeigt die Detailseite:
- Code - der vom Käufer im Zahlungsformular eingegebene Code, bevor er geprüft und aktiviert wird. Wird nur für Anwendungen mit temporären, an ein Gerät gebundenen Codes angezeigt.
- Zahlungsbetrag (Brutto) - der vom Zahlungssystem bestätigte Betrag, vor Abzug der Gebühren des Zahlungssystems und von PayToUse.
- Zahlungsbetrag (Netto) - der vom Zahlungssystem bestätigte Betrag, nach Abzug der Gebühren des Zahlungssystems und von PayToUse.
-
Zahlungskennungen - vom Zahlungssystem zugewiesene Kennungen, mit denen die Zahlung bei Bedarf dort nachgeschlagen werden kann. Die angezeigten Felder hängen vom Zahlungssystem ab:
- Stripe: Payment Intent, Belegnummer, Letzte 4 Ziffern.
- PayPal: Zahlungs-ID, Zahler-ID, Transaktions-ID.
- Robokassa: Zahlungs-ID, ID1, ID2.
Wenn für die Zahlung ein Code gesendet wurde, sind auf der Detailseite der Zahlung die Schaltflächen Code zurücksetzen, Code senden und E-Mail ändern verfügbar. Sie funktionieren genauso wie auf der Detailseite des Codes. (siehe Code-Details)
Zahlungsstatus
Während ihres Lebenszyklus durchläuft die Zahlung verschiedene Zustände, die über den Zahlungsstatus nachverfolgt werden können.
| Status | Beschreibung |
|---|---|
| Unvollständig | Dieser Status wird Zahlungen zugewiesen, für die keine Aktionen durchgeführt wurden. Die Zahlung wird erstellt, sobald der Benutzer vom Zahlungsformular zum Zahlungssystemformular wechselt. Der Zahlung wird eine eindeutige Seriennummer sowie die grundlegenden Zahlungseigenschaften zugewiesen: Betrag, Zahlungssystem, Datum. |
| Erfolgreich | Dieser Status wird Zahlungen zugewiesen, die eine positive Antwort vom Zahlungssystem erhalten haben. Der nächste Schritt besteht darin, dem Benutzer eine E-Mail mit dem generierten Code oder anderen Daten je nach Anwendungseinstellungen zu senden. Wenn die Zahlung in diesem Status verbleibt, ist es erforderlich, ihr besondere Aufmerksamkeit zu widmen, da die nachfolgenden Aktionen nicht durchgeführt wurden. |
| Fehler | Dieser Status wird Zahlungen zugewiesen, für die eine negative Antwort vom Zahlungssystem empfangen wird. Nachfolgende Schritte werden nicht ausgeführt. Es ist wichtig, solche Zahlungen besonders zu beachten, da der Status auf Seite des Zahlungssystems mit Verzögerung verarbeitet werden kann. |
| Ausstehend | Dieser Status wird Zahlungen zugewiesen, für die eine positive Antwort vom Zahlungssystem erhalten wurde und alle nachfolgenden Schritte erfolgreich durchgeführt wurden. Eine Auszahlung für Zahlungen mit diesem Status ist nicht verfügbar. Zahlungen wechseln automatisch nach 7 Tagen in den nächsten Status. |
| Verfügbar | Eine Auszahlung ist für Zahlungen in diesem Status verfügbar. |
| Senden | Dieser Status wird Zahlungen zugewiesen, die in der nächsten Auszahlung enthalten sind. Wenn die Auszahlung storniert oder abgelehnt wird, wird der Zahlungsstatus auf Verfügbar zurückgesetzt. |
| Gesendet | Dieser Status wird Zahlungen zugewiesen, für die die Auszahlung erfolgt ist. Die Bestätigung des Erhalts der Mittel steht noch aus. |
| Abgeschlossen | Dieser Status wird Zahlungen mit erfolgreichen Auszahlungen zugewiesen. Sie können den Status manuell festlegen, indem Sie die Auszahlung im entsprechenden Bereich bestätigen. Der Status wird auch automatisch 14 Tage nach der Auszahlung der Zahlung geändert. |
| Erstattet | Zahlungen, für die eine Rückerstattung ausgestellt wurde, werden in diesen Status überführt. Bei Ausgabe einer Rückerstattung wird eine Rückerstattungsgebühr erhoben. Die Gebühr wird vom Auszahlungsbetrag abgezogen. |
| Erstattung geschlossen | Eine Erstattung, die in einer bereits gesendeten Auszahlung enthalten war. Die Erstattungsgebühr wird stattdessen vom Guthaben des Entwicklers abgezogen, da der ausgezahlte Betrag nicht mehr reduziert werden kann. |
| Streitfall | Der Käufer hat die Zahlung beim Zahlungssystem angefochten (Rückbuchung). Das Ergebnis steht noch aus. |
| Streitfall geschlossen | Der Streitfall wurde gelöst. Wie bei einer Erstattung wird jede vom Zahlungssystem erhobene Streitfallgebühr an den Entwickler weitergegeben. |
| Abgebrochen | Die Zahlung wurde vor Abschluss storniert. |
| Unbekannt | Wird zugewiesen, wenn beim Abgleich von Zahlungsdatensätzen mit einem Bericht des Zahlungssystems der Statustext keinem der oben bekannten Status entspricht. Erfordert eine manuelle Überprüfung. |
| Test | Eine Testzahlung, die über den Testmodus der Anwendung getätigt wurde, während sie sich im Status Test befindet, vor dem Start. Der Betrag und jeder generierte Code sind real, aber es wird kein Geld abgebucht, und die Zahlung wird von den Dashboard-Summen ausgeschlossen. |
Herunterladen
Die Schaltfläche Herunterladen in der Titelleiste der Zahlungsliste lädt die Liste als Excel-Datei (XLSX) herunter. Die Datei enthält die im Filter Spalten ausgewählten Spalten in derselben Reihenfolge sowie alle Zahlungen, die den aktuellen Filtern und der Suche entsprechen, nicht nur die Zahlungen der aktuellen Seite.
Auszahlungen
Wenn Sie diesen Abschnitt öffnen, wird eine Liste Ihrer Auszahlungen geöffnet.
Auszahlen
Über die Schaltfläche „Auszahlen“ können Sie eine Überweisung Ihrer Einnahmen beantragen.
Wenn Sie auf diese Schaltfläche klicken, öffnet sich ein Modalfenster, in dem Sie die Zahlungsdaten für die Überweisung angeben müssen.
Wichtiger Hinweis: Das System verwendet für die Auszahlung automatisch den gesamten verfügbaren Betrag, der im entsprechenden Feld angezeigt wird. Sie können keinen beliebigen Betrag angeben, der unter dem verfügbaren Guthaben liegt. Der Gesamtauszahlungsbetrag entspricht der Summe aller Zahlungen, die den Status „zur Auszahlung verfügbar“ haben.
Im Modalfenster können Sie den Betrag und die Währung für die Auszahlung auswählen. Die verfügbaren Währungen richten sich nach Ihren Zahlungsmethoden.
Hinweis: Wenn die ausgewählte Währung für die angegebene Auszahlungsmethode nicht unterstützt wird, wird der Auszahlungsantrag abgelehnt.
Liste der Auszahlungen
Der zuletzt verwendete Filter wird für den Benutzer gespeichert. Das heißt, beim nächsten Besuch der Seite wird der zuletzt verwendete Filter automatisch angewendet. Für die Liste der Auszahlungen stehen Filter zur Verfügung:
- Spalten - Zeigen Sie nur ausgewählte Spalten in der Liste der Auszahlungen an.
- Status - Zeige nur Auszahlungen an, die sich in den ausgewählten Status befinden.
Die Liste der Spalten in der Tabelle der Auszahlungen:
- # - Eindeutige Sequenznummer der Auszahlung. Sie wird der Auszahlung automatisch zugewiesen, wenn die Auszahlung gespeichert wird. Sie können auf den Link klicken, um die Details der Auszahlung anzuzeigen.
- Status - der Auszahlungsstatus. (siehe Auszahlungsstatus)
- Erstellt - das Datum des Auszahlungsantrags.
- Betrag - der Auszahlungsbetrag.
- Auszahlung - das Datum, an dem die Auszahlung gesendet wurde.
- Schaltflächen für Aktionen mit Auszahlungen. Zum Beispiel Bestätigung.
Sie können die Auszahlung bestätigen, wenn sie sich im Status Gesendet befindet.
Auszahlungsdetails
Ein Klick auf die # einer Auszahlung in der Liste öffnet ihre Detailseite. Zusätzlich zu den Feldern der Liste zeigt sie die Details - die im Auszahlungsantrag angegebenen Zahlungsdaten, auf die die Mittel überwiesen werden.
Darunter befindet sich die Liste der in der Auszahlung enthaltenen Zahlungen. Dafür sind die Filter Spalten, Anwendung, System und Status verfügbar, wie in der Zahlungsliste. (siehe Liste der Zahlungen)
Auszahlungsstatus
Während ihres Lebenszyklus durchläuft die Auszahlung verschiedene Zustände, die über den Auszahlungsstatus verfolgt werden können.
| Status | Beschreibung |
|---|---|
| Ausstehend | Der Status wird Auszahlungen bei der Erstellung zugewiesen, solange noch keine Aktionen durchgeführt wurden. |
| Abgebrochen | Der Status wird stornierten Auszahlungen zugewiesen. Stornierungen können aus verschiedenen Gründen erfolgen. Zum Beispiel, wenn die Methode zum Empfang von Geldern nicht angegeben ist. Alle Zahlungen dieser Auszahlung gehen in den Verfügbar-Status und sind erneut zur Auszahlung verfügbar. |
| Gesendet | Der Status wird für die Auszahlung von Geldern gesetzt, wenn diese gesendet wird. |
| Abgeschlossen | Der Status wird für manuelle Auszahlungen gesetzt, wenn der Entwickler den Erhalt bestätigt, oder automatisch 14 Tage nach dem Versand. |
| Abgelehnt | Der Status wird für die Auszahlung gesetzt, wenn die Bank oder das Zahlungssystem Gelder nach dem Versand zurücksendet. Alle Zahlungen dieser Auszahlung gehen in den Verfügbar-Status und sind erneut zur Auszahlung verfügbar. |
Zifferblatt-Designer
Der Designer erstellt Garmin Connect IQ-Zifferblätter für Ihre App ohne Programmierung. Sie platzieren Elemente auf dem Bildschirm jedes Uhrenmodells, wählen, was sie anzeigen und welche davon kostenpflichtig sind, und laden eine fertige Datei herunter: .prg zur Installation auf Ihrer eigenen Uhr zum Testen oder .iq zur Veröffentlichung im Connect IQ Store.
Das fertige Zifferblatt prüft die Zahlung selbst über PayToUse entsprechend der Zahlungsmethode der App. Sie müssen keinen Code schreiben.
Der Designer wird mit der Raketen-Schaltfläche neben dem App-Namen auf der App-Seite geöffnet.
Connect IQ-Entwicklerschlüssel
Jede .prg- und .iq-Datei wird mit dem Entwicklerschlüssel signiert, einem privaten RSA-Schlüssel mit 4096 Bit. Er wird einmal im Profil festgelegt und für alle Zifferblätter des Entwicklers verwendet.
- Wenn Sie bereits Apps im Connect IQ Store haben, laden Sie den Schlüssel hoch, mit dem Sie sie signiert haben: die vom Connect IQ SDK erstellte Datei developer_key (zum Beispiel mit dem Befehl "Monkey C: Generate a Developer Key" in Visual Studio Code). Eine im Store veröffentlichte App kann nur mit demselben Schlüssel aktualisiert werden.
- Wenn Sie noch keinen Schlüssel haben, erzeugen Sie ihn mit der Schaltfläche „Neuen Schlüssel erzeugen“. Ein solcher Schlüssel eignet sich zur Installation von Zifferblättern auf Ihrer Uhr und für neue Apps im Store, aber bereits mit einem anderen Schlüssel veröffentlichte Apps können damit nicht aktualisiert werden.
- Laden Sie den Schlüssel herunter und bewahren Sie eine Kopie an einem sicheren Ort auf. Geht der Schlüssel verloren, können damit veröffentlichte Apps im Store nicht mehr aktualisiert werden.
- Dateien im DER- oder PEM-Format werden akzeptiert. Der Schlüssel darf nicht passwortgeschützt sein.
Wichtig: Das Ersetzen des Schlüssels betrifft alle Zifferblätter des Entwicklers. Der vorherige Schlüssel bleibt auf dem Server gespeichert, neue Builds werden jedoch mit dem neuen signiert.
Uhrenmodelle
Die Liste der im Designer verfügbaren Modelle legt der Administrator auf der Seite Uhrenmodelle fest: runde und rechteckige Modelle mit Connect IQ 4 und neuer. Im Designer wählen Sie die Modelle für das Zifferblatt mit der Schaltfläche Modelle.
Jedes Modell hat sein eigenes Layout: Position, Größe und Schrift der Elemente werden separat festgelegt, während Elementliste, Funktionen und Zahlungseinstellungen für alle Modelle gleich sind. Ein neu hinzugefügtes Modell erhält das Layout des aktuellen Modells, skaliert auf seinen Bildschirm.
- Uhr / Bildschirm - den Bildschirm auf dem Bild der Uhr oder nur den Bildschirm anzeigen.
- Echte Größe - die Uhr in ihrer tatsächlichen Größe anzeigen.
- Always On - Vorschau des Always-On-Modus von AMOLED-Bildschirmen.
Elemente
Ein Zifferblatt besteht aus Elementen von vier Typen:
- Text - zeigt den Wert einer Funktion: Uhrzeit, Datum, Schritte, Herzfrequenz, Wetter usw.
- Statischer Text - Text, den Sie selbst eingeben.
- Zeiger - analoge Stunden-, Minuten- und Sekundenzeiger.
- Bild - ein Bild: Hintergrund oder Ebene über anderen Elementen.
Elemente werden in der Reihenfolge der Liste auf der Registerkarte Elemente gezeichnet: Das erste ist die unterste Ebene. Die Reihenfolge wird mit den Pfeilen in der Liste und den Schaltflächen Nach hinten und Nach vorne geändert.
Elemente werden mit der Maus oder den Pfeiltasten verschoben (1 px, mit Umschalt 10 px). Strg+D dupliziert das Element, Strg+C / Strg+V kopieren seine Position in ein anderes Modell, Entf löscht es. Die Schaltfläche In alle Modelle kopieren überträgt die Position des Elements auf alle ausgewählten Modelle. Die Schaltfläche Alles in alle Modelle kopieren ersetzt die Layouts aller anderen Modelle durch das Layout des aktuellen Modells: alle Elemente und den Hintergrund, skaliert auf jeden Bildschirm.
Funktionen und Zahlung
Ein Textelement kann mehrere Funktionen haben. Eine davon wird standardmäßig angezeigt; wenn Benutzer kann die Funktion in den Einstellungen wählen aktiviert ist, wählt der Uhrenbesitzer die Funktion in den Zifferblatt-Einstellungen in Garmin Connect.
Jede Funktion jedes Elements kann als kostenpflichtig markiert werden: Dieselbe Funktion kann in einem Element kostenlos und in einem anderen kostenpflichtig sein. Die Registerkarte Funktionen zeigt alle verwendeten Funktionen und Elemente in einer Tabelle.
Mit einem Sternchen markierte Funktionen benötigen eine zusätzliche Berechtigung (Sensorverlauf, Benutzerprofil oder Standort), die der Store bei der Installation des Zifferblatts anzeigt. Die Berechtigung wird dem Zifferblatt nur hinzugefügt, wenn es solche Funktionen verwendet. Sonnenaufgang und -untergang sowie Tag-/Nacht-Symbole benötigen den Standort: die letzte GPS-Position der Uhr (wird von jeder Aktivität mit GPS aktualisiert), sonst den Ort der Wettervorhersage.
Ohne Zahlung verhält sich das Zifferblatt je nach Zahlungsmethode der App:
| Zahlungsmethode | Ohne Zahlung |
|---|---|
| Preisberechnung abhängig von der Laufzeit, Laufzeitberechnung abhängig vom Preis, Permanenter Code | Kostenpflichtige Funktionen zeigen „paid“, kostenpflichtige Bilder werden ausgeblendet. Der Freischaltcode wird in den Zifferblatt-Einstellungen eingegeben; der QR-Code der Kaufseite befindet sich im Einstellungsmenü auf der Uhr. |
| Temporärer Code mit Preis abhängig von der Laufzeit, Temporärer Code mit Laufzeit abhängig vom Preis | Wenn das Zifferblatt kostenpflichtige Funktionen verwendet, zeigt es einen Sperrbildschirm mit dem Code der Uhr und dem QR-Code der Zahlungsseite. |
| Spende | Es gibt keine Zahlungsprüfung, Kostenpflichtig-Markierungen werden ignoriert. |
Auf Touchscreens öffnet ein Tippen auf ein gesperrtes Zifferblatt alle Funktionen für 15 Minuten als Testversion.
Symbole
Ein Textelement kann neben dem Wert der Funktion ein Symbol anzeigen. Das Symbol gehört zur Funktion im gesamten Zifferblatt: Es wird in der Spalte Symbol der Funktionstabelle eines Elements oder auf der Registerkarte Funktionen geändert, und die Änderung gilt für alle Elemente mit dieser Funktion.
- Aus dem Verzeichnis (standardmäßig) - das Symbol, das der Administrator für diese Funktion im Symbolverzeichnis festgelegt hat.
- Kein Symbol - die Funktion wird ohne Symbol angezeigt.
- Ein Symbol - ein beliebiges Symbol der gemeinsamen Bibliothek oder Ihrer eigenen Symbole.
- Satz - das Symbol hängt vom Wert der Funktion ab: Es wird die erste Zeile verwendet, deren „bis“-Wert nicht kleiner als der Wert ist, die letzte Zeile gilt für alle größeren Werte. Mit „Tag / Nacht“ hat jede Zeile ein eigenes Nachtsymbol, das zwischen Sonnenuntergang und Sonnenaufgang verwendet wird.
Werte für Sätze: Akku - Ladung in %, Wecker - ihre Anzahl, Telefonverbindung und Nicht stören - 1 oder 0, Mond - Alter in Tagen, Wind - Richtung in Grad, Wetter - Zustandscode; andere Funktionen - ihre Zahl ohne Einheit. Während der Akku lädt, werden die Akkusymbole nacheinander angezeigt.
Die Einstellung Anzeigen eines Elements wählt Text und Symbol, nur Text oder nur Symbol. Position des Symbols relativ zum Text, Größe, Farbe, Abstand und Versatz werden im Layout jedes Modells festgelegt. Die Ausrichtung des Elements gilt für den gesamten Block: Text, Abstand und Symbol zusammen.
Eigene Symbole werden auf der Registerkarte Zifferblatt im Abschnitt Symbole des Zifferblatts hinzugefügt: SVG-Dateien (mehrere auf einmal) oder eine TTF-Schrift, deren Zeichen jeweils zu einem Symbol werden. Anforderungen an SVG:
- Symbole sind einfarbig: Die Farben der Datei werden ignoriert, das Symbol wird in der im Designer gewählten Farbe gezeichnet;
- nur gefüllte Formen werden verwendet; Linien ohne Füllung (stroke) müssen in einem Vektoreditor in Formen umgewandelt werden (zum Beispiel „Kontur in Pfad“ in Inkscape oder „Outline Stroke“ in Figma und Illustrator);
- Löcher müssen echte Aussparungen sein (zusammengesetzter Pfad oder Füllregel evenodd): Eine weiße Form über einer schwarzen wird zu einer gefüllten Fläche;
- die Größe des Symbols ist die viewBox der Datei; Verläufe, Masken, Text und CSS-Klassen werden nicht unterstützt.
Auf der Uhr werden die Symbole beim Erstellen des Zifferblatts in Bitmaps der benötigten Größe umgewandelt.
Schriften und Bilder
- Die Systemschriften der Uhr sind für jedes Modell verfügbar. Zahlenschriften enthalten nur Ziffern und wenige Zeichen.
- Eigene TTF- oder OTF-Schriften werden auf der Registerkarte Zifferblatt hochgeladen und für jedes Modell und jede Größe in Bitmaps umgewandelt. Ein Modell kann zusammen bis zu 12 verschiedene Größen eigener Schriften und Symbole haben.
- Bilder (PNG, JPEG, GIF, WebP bis 2000×2000) werden auf derselben Registerkarte hochgeladen. Ein Bild füllt entweder den Bildschirm jedes Modells aus oder hat seine eigene Größe; es wird für jedes Modell skaliert, die Transparenz bleibt erhalten. Bis zu 8 verschiedene Bilder oder Größen pro Modell.
- Bilder belegen Grafikspeicher der Uhr; der Designer zeigt, wie viel davon auf dem aktuellen Modell verwendet wird.
Always-On-Modus
Auf AMOLED-Bildschirmen zeigt das Zifferblatt im Always-On-Modus nur die Elemente mit der Markierung Im Always-On-Modus anzeigen, auf schwarzem Hintergrund und mit einer kleinen Verschiebung jede Minute zum Schutz des Bildschirms. Garmin erlaubt in diesem Modus höchstens 10 % leuchtende Pixel; der Designer zeigt diesen Wert über dem Bildschirm an. Sekunden und Sekundenzeiger werden in diesem Modus nicht angezeigt.
Erstellen
- Für diese Uhr erstellen (.prg) - Datei für das aktuelle Modell zur Installation auf Ihrer Uhr.
- Für den Connect IQ Store erstellen (.iq) - Paket für alle ausgewählten Modelle zur Veröffentlichung im Connect IQ Store. Jeder .iq-Build erhält eine neue Versionsnummer.
Builds werden in eine Warteschlange gestellt und dauern meist etwa eine Minute. Die Registerkarte Builds zeigt den Status, den Download-Link und das Build-Protokoll.
Die App-UUID auf der Registerkarte Zifferblatt identifiziert die App im Store. Ändern Sie sie nicht zwischen Versionen. Um eine bereits veröffentlichte App zu aktualisieren, geben Sie deren UUID ein.
Installieren einer .prg-Datei auf der Uhr
Verbinden Sie die Uhr mit dem USB-Kabel mit dem Computer und kopieren Sie die .prg-Datei in den Ordner GARMIN/Apps der Uhr. Nach dem Trennen des Kabels erscheint das Zifferblatt in der Liste der Zifferblätter auf der Uhr.
- Windows: Die Uhr erscheint im Datei-Explorer als Gerät (zum Beispiel "fēnix 7"). Öffnen Sie Internal Storage → GARMIN → Apps und kopieren Sie die Datei dorthin.
- macOS: Die meisten modernen Uhren werden über MTP verbunden, das macOS ohne zusätzliche Software nicht unterstützt. Installieren Sie OpenMTP (kostenlos), verbinden Sie die Uhr, öffnen Sie GARMIN/Apps und kopieren Sie die Datei dorthin. Schließen Sie vorher Garmin Express, sonst übernimmt es die Verbindung.
- Linux: Die Uhr erscheint im Dateimanager (GNOME Files, Dolphin) als MTP-Gerät; öffnen Sie GARMIN/Apps und kopieren Sie die Datei dorthin. Ohne grafische Umgebung kann die Uhr mit jmtpfs oder simple-mtpfs eingebunden werden.
Um das Zifferblatt zu entfernen, löschen Sie die Datei aus GARMIN/Apps oder entfernen Sie es auf der Uhr.
Hinweis: Die Einstellungen eines auf diese Weise installierten Zifferblatts können in der Garmin Connect App nicht geändert werden, es verwendet die Standardeinstellungen. Um die Einstellungen zu testen, veröffentlichen Sie das Zifferblatt im Store als Beta-App.
Veröffentlichung im Connect IQ Store
Der Designer lädt keine Dateien in den Store hoch. Melden Sie sich im Connect IQ-Entwickler-Dashboard (apps.garmin.com/developer) an, erstellen Sie eine App vom Typ "watch face", laden Sie die .iq-Datei hoch, fügen Sie eine Beschreibung und Screenshots hinzu und reichen Sie die App zur Prüfung ein.
Um die App zu aktualisieren, erstellen Sie eine neue .iq-Datei (ihre Version erhöht sich automatisch) und laden Sie sie als neue Version derselben App hoch. UUID und Entwicklerschlüssel müssen gleich bleiben.
API
Übersicht
Die PayToUse-API erfüllt folgende Funktionen:
- Prüft den Aktivierungsstatus eines Freischaltcodes und aktiviert ihn gegebenenfalls.
- Ruft Blutzuckerdaten aus der NightScout-App ab.
- Ruft aktuelle Wetterdaten für einen angegebenen Ort ab.
Alle Informationen können in einer einzigen Anfrage angefordert und empfangen werden.
API-Endpunkte
Sie können einen der folgenden Endpunkte verwenden:
- https://api.pay-to-use.com
- https://api.p2u.io
Beide Endpunkte verarbeiten GET- und POST-Anfragen.
Anfrageparameter
- device: string (erforderlich) — eindeutige Gerätekennung
- app: integer (erforderlich) — Ihre Anwendungs-ID
- model: string (optional) — Gerätemodellcode, der zum Erfassen und Anzeigen von Statistiken für Geräte, die die App verwenden, benötigt wird
- code: string (optional) — Freischaltcode
- bg: assoziatives Array (optional) — Daten zum Anfordern von Blutzuckerwerten aus der NightScout-App
- url: string (optional) — Adresse der NightScout-App
- weather: assoziatives Array (optional) — Daten zur Anforderung des aktuellen Wetters
- appid: string (optional) — Zugriffsschlüssel für die Wetter-API
- lat: float (optional) — Breitengrad
- lon: float (optional) — Längengrad
- provider: integer (optional) — Wetterdienst
Liste der unterstützten Wetterdienste
1. OpenWeatherMap
- Beschreibung: OpenWeatherMap bietet globale Wetterdaten, darunter Echtzeitdaten, historische Daten und 16-Tage-Vorhersagen. Dank der großen geografischen Abdeckung und der häufigen Aktualisierungen ist OpenWeatherMap eine beliebte Wahl für Anwendungen, die sowohl aktuelle Wetterdaten als auch Langzeitprognosen benötigen.
- Bereitgestellte Daten: Temperatur, Luftfeuchtigkeit, Windgeschwindigkeit, Luftqualität, Niederschlagswahrscheinlichkeit und mehr in Echtzeit. Bietet sowohl aktuelle als auch prognostizierte Daten, einschließlich minutengenauer Wetterdaten für ausgewählte Standorte.
- Anbieterauswahl: Geben Sie im Abschnitt weather Ihrer Anfrage provider = 1 an, um OpenWeatherMap als Wetteranbieter auszuwählen.
- Nutzungshinweise: Es werden kostenlose und kostenpflichtige Tarife angeboten, wobei der Datenzugriff über API-Schlüsselauthentifizierung erfolgt. Erweiterte Datenebenen und Premium-Funktionen sind in den kostenpflichtigen Tarifen verfügbar.
- One Call API 3.0: Der UV-Index ist nur mit einem Schlüssel verfügbar, der One Call API 3.0 abonniert hat (ein separates Abonnement in Ihrem OpenWeatherMap-Konto). Mit einem solchen Schlüssel ersetzt eine One-Call-Anfrage die separaten Anfragen für aktuelles Wetter und Vorhersage. Lehnt One Call den Schlüssel ab, wird die kostenlose API 2.5 verwendet und One Call nach einem Tag erneut versucht.
- API-Dokumentation: Verfügbar hier.
2. QWeather
- Beschreibung: QWeather, auch bekannt als HeWeather, bietet umfassende Wetterdaten mit Schwerpunkt auf China, beinhaltet aber auch internationale Daten. Es liefert detaillierte Informationen wie Echtzeitwetter, Vorhersagen, Luftqualitätsinformationen und Warnmeldungen.
- Bereitgestellte Daten: Aktuelle Temperatur, Luftfeuchtigkeit, UV-Index, Schadstoffbelastung, Tages- und Stundenvorhersagen sowie Warnungen vor Unwettern. Bekannt für seine detaillierten Luftqualitätsdaten und Echtzeit-Updates zu sich ändernden Wetterbedingungen.
- Anbieterauswahl: Geben Sie im Abschnitt weather Ihrer Anfrage provider = 2 an, um QWeather als Wetteranbieter auszuwählen.
- Nutzungshinweise: QWeather bietet API-Zugriff mit kostenlosen und Premium-Tarifen. Der kostenlose Tarif umfasst eingeschränkte Daten, während die Premium-Optionen zusätzliche Datenpunkte und Standorte abdecken.
- API-Dokumentation: Verfügbar hier.
3. MET Weather (MET Norway)
- Beschreibung: Die von MET Norway bereitgestellte MET Weather API bietet Zugriff auf eine Vielzahl offener meteorologischer Daten, darunter Vorhersagen, historische Daten und spezifische Daten für Norwegen und die nordischen Länder. MET Weather ist bekannt für seine Genauigkeit und Transparenz und eignet sich ideal für Anwendungen, die hochzuverlässige Wetterdaten benötigen.
- Bereitgestellte Daten: Aktuelle Wetterbedingungen, Vorhersagen, Niederschlag, Temperatur, Winddaten und UV-Index. MET Weather bietet spezialisierte Daten für die nordischen Regionen, unterstützt aber auch globale Wetterinformationen.
- Anbieterauswahl: Geben Sie im Abschnitt weather Ihrer Anfrage provider = 3 an, um MET Weather als Wetteranbieter auszuwählen.
- Nutzungshinweise: Alle von MET Weather bereitgestellten Daten stehen unter einer Creative-Commons-Lizenz zur freien Nutzung zur Verfügung und ermöglichen somit sowohl nicht-kommerzielle als auch kommerzielle Anwendungen kostenlos. MET Norway ist für seine Umweltdaten bekannt und genießt daher insbesondere in Europa hohes Vertrauen.
- API-Dokumentation: Verfügbar hier.
Beispielanfrage
function onTemporalEvent() as Void {
var ds = System.getDeviceSettings();
if (!ds.phoneConnected) { // Prüft, ob das Gerät mit dem Telefon verbunden ist, um die Anfrage zu senden.
return;
}
var id = ds.uniqueIdentifier;
if (id == null) { // Prüft, ob dem Gerät eine eindeutige Kennung zugewiesen wurde
return;
}
var request = {};
var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
if (lockCheck == null || lockCheck <= Time.now().value()) { // Sendet den Code bei Bedarf
request.put("code", Application.Properties.getValue("UnlockCode"));
}
var ns_url = Application.Properties.getValue("NS");
if (!ns_url.equals("")) { // Sendet bei Bedarf die URL der NightScout-App
request.put("bg", { "url" => ns_url });
}
var wP = Application.Properties.getValue("Weather");
if (wP != 0) { // Sendet bei Bedarf Wetteranfrageparameter
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()) {
// Füllt die erforderlichen Anfrageparameter aus
request.put("device", id);
request.put("app", p2uAppID); // Ihre Anwendungs-ID
request.put("model", ds.partNumber);
Toybox.Communications.makeWebRequest(
"https://api.p2u.io", // API-Endpunkt
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)
);
}
}
API-Antwort
Die API gibt ein JSON-Objekt mit Informationen zum Entsperrstatus, zum Blutzuckerspiegel und zum Wetter zurück.
Antwortparameter
Ergebnisse der Freischaltcode-Verifizierung (falls eine Anfrage gesendet wurde):
- response: integer — Rückgabecode
- msg: string — Nachricht über das Verifizierungsergebnis
- code: string — der Freischaltcode, auf den sich das Ergebnis bezieht, falls bekannt
- expires: integer — Ablaufzeitstempel des Codes im UNIXTIMESTAMP-Format
- qr: array — QR-Code zur Kauf- oder Seriennummernprüfung, falls zutreffend
Antwort der NightScout-App (falls eine Anfrage gesendet wurde):
- bg: assoziatives Array — formatierte Antwort der NightScout-App
- value: integer — Blutzuckerspiegel in mg/dL
- date: integer — Zeitstempel des Codeablaufs im UNIXTIMESTAMP-Format
- direction: string — Trend bei der Veränderung des Blutzuckerspiegels
Antwort der Wetter-API (falls eine Anfrage gesendet wurde):
- weather: assoziatives Array — formatierte Antwort der Wetter-API
- provider: integer — Kennung des Wetterdienstes
- weather: array — Aktuelle Wetterbedingungen. Es können ein oder zwei Werte zurückgegeben werden; werden zwei Werte zurückgegeben, repräsentieren diese die Bedingungen am Tag und in der Nacht
- temp: float — aktuelle Temperatur in Grad Celsius
- feels_like: float — Gefühlte Temperatur in Celsius
- pressure: integer — atmosphärischer Druck in hPa
- humidity: integer — Luftfeuchtigkeit in %
- precipitation: integer — Niederschlagswahrscheinlichkeit in %
Bei MET Weather nur in den nordischen Ländern. -1, wenn der Wert nicht verfügbar ist. - wind: integer — Windrichtung in Grad
- wind_speed: float — Windgeschwindigkeit in m/s
- wind_gust: float — Windböengeschwindigkeit in m/s
Für QWeather nicht verfügbar. Bei MET Weather nur in den nordischen Ländern. -1, wenn der Wert nicht verfügbar ist. - uvi: float — UV-Index
Bei OpenWeatherMap nur mit einem Schlüssel mit One-Call-API-3.0-Abonnement. Bei QWeather das Tagesmaximum. Bei MET Weather der UV-Index bei klarem Himmel. -1, wenn der Wert nicht verfügbar ist. - temp_low: float — Heutige Tiefsttemperatur in Celsius
- temp_high: float — Heutige Höchsttemperatur in Celsius
- sunrise_today: integer — Heutiger Sonnenaufgangszeitstempel im UNIXTIMESTAMP-Format
- sunset_today: integer — Heutiger Sonnenuntergangszeitstempel im UNIXTIMESTAMP-Format
- sunrise_tomorrow: integer — Zeitstempel für Sonnenaufgang morgen im UNIXTIMESTAMP-Format
- sunset_tomorrow: integer — Zeitstempel für Sonnenuntergang morgen im UNIXTIMESTAMP-Format
- aqi: assoziatives Array — Luftqualitätsindex
- level: integer — Stufe des Luftqualitätsindex
- value: integer — Wert des Luftqualitätsindex
Beispielantwort
{
"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
}
}
}
Antwortcodes
Das Feld response des Ergebnisses der Freischaltcode-Prüfung nimmt einen der folgenden Werte an. Beispielantworten und die Reihenfolge der Prüfungen sind unter Überprüfungen auf der API-Seite beschrieben.
| Code | Beschreibung |
|---|---|
| 101 | Der Code ist gültig. Die Anwendung kann freigeschaltet werden. |
| 102 | Kein gültiger Code, aber der Testzeitraum ist noch nicht abgelaufen. Die Anwendung kann bis zum Datum im Feld expires freigeschaltet werden. |
| 103 | Kein gültiger Code, aber das Gerät ist ein Betatester: Sein erster API-Aufruf erfolgte vor dem Datum im Feld Veröffentlichungsdatum der Anwendung. Die Anwendung kann bis zum Datum im Feld expires freigeschaltet werden (0 - unbegrenzt). |
| 201 | Der Code wurde nicht gefunden oder wurde gelöscht. |
| 202 | Der Code ist bereits auf einem anderen Gerät aktiviert. |
| 203 | Der Code ist abgelaufen. |
| 204 | Der Testzeitraum ist abgelaufen und es wurde kein gültiger Code gesendet. |
| 301 | Die Anwendung wurde nicht gefunden oder ist nicht verfügbar. |
| 302 | Die Laufzeit des Codes ist nicht definiert. |
| 303 | Nicht genügend Parameter in der Anfrage. |
| 304 | Für diese Anwendung ist die Gerätekennung erforderlich. |
| 401 | Fehler beim Speichern des Codes. Schreiben Sie an den Support unter [email protected]. |
| 402 | Fehler beim Speichern des Geräts. Schreiben Sie an den Support unter [email protected]. |
| 500 | Unbekannter Fehler. Schreiben Sie an den Support unter [email protected]. |
Codes 1xx bedeuten, dass die Anwendung freigeschaltet werden kann, 2xx - dass sie gesperrt bleiben muss, 3xx - einen Fehler in der Anfrage, 4xx und 5xx - einen Fehler auf der Seite von PayToUse. Bei Fehlern 4xx und 5xx wird empfohlen, das letzte erfolgreiche Ergebnis beizubehalten und die Anfrage später zu wiederholen.
Wenn die Option Erneutes Senden des Codes per Geräte-ID erlauben in den Anwendungseinstellungen aktiviert ist, die Anfrage eine Gerätekennung, aber keinen Code enthält und diesem Gerät bereits ein gültiger Code zugeordnet ist, gibt die API 101 zusammen mit diesem Code im Feld code zurück. Die Anwendung kann ihn speichern und den Benutzer nicht mehr zur Eingabe auffordern.
Notizen
- Anfragen mit bg erfordern eine Verbindung zur NightScout-App.
- Bei jeder Anfrage mit code prüft die API automatisch den Code-Status und aktiviert ihn, falls er inaktiv ist.
- Bitte beachten Sie, dass API-Parameter im Laufe der Zeit aktualisiert oder geändert werden können, um Funktionalität, Kompatibilität und Sicherheit zu verbessern. Es wird empfohlen, die API-Dokumentation regelmäßig auf Änderungen zu überprüfen, die die Integration oder Nutzung beeinträchtigen könnten.
Wetteranbieter
Nachfolgend die Zuordnung der im Feld weather zurückgegebenen Wetterbedingungen zu den Werten der einzelnen Anbieter.
Garmin
Eine detaillierte Beschreibung der Wetterfunktionen und -konstanten des Garmin SDK finden Sie unter diesem Link. Je nach gewähltem Wetterdienstanbieter können Sie Werte, die Sie über die API erhalten, oder Ergebnisse der Garmin SDK-Wetterfunktionen speichern, um eine konsistente Anzeige der Werte auf dem Bildschirm zu gewährleisten.
| ID | Beschreibung | Tag | Nacht |
|---|---|---|---|
| 0 | Klarer Himmel |
0x53 |
0x54 |
| 40 | Heiter | ||
| 23 | Überwiegend klar |
0x55 |
0x56 |
| 1 | Wechselnd bewölkt |
0x57 |
0x58 |
| 22 | Teilweise klar | ||
| 2 | Überwiegend bewölkt |
0x59 |
|
| 52 | Dünne Wolken | ||
| 20 | Bewölkt |
0x5A |
|
| 45 | Bewölkt, Regen möglich | ||
| 31 | Nieselregen |
0x3E |
|
| 14 | Leichter Regen |
0x42 |
|
| 24 | Leichte Schauer | ||
| 3 | Regen |
0x43 |
|
| 25 | Schauer | ||
| 27 | Schauerwahrscheinlichkeit |
0x46 |
|
| 11 | Vereinzelte Schauer | ||
| 15 | Starkregen | ||
| 26 | Starke Schauer | ||
| 28 | Gewitterwahrscheinlichkeit |
0x36 |
0x37 |
| 12 | Vereinzelte Gewitter |
0x38 |
|
| 6 | Gewitter |
0x39 |
|
| 8 | Nebel |
0x4E |
|
| 9 | Dunstig | ||
| 29 | Leichter Nebel | ||
| 39 | Dunst | ||
| 30 | Staub |
0x4F |
|
| 35 | Sand | ||
| 33 | Rauch | ||
| 38 | Vulkanasche | ||
| 37 | Sandsturm | ||
| 13 | Niederschlag | ||
| 5 | Windig |
0x52 |
|
| 36 | Böen | ||
| 48 | Schneeschauer | ||
| 32 | Tornado |
0x50 |
|
| 41 | Hurrikan | ||
| 42 | Tropensturm | ||
| 50 | Eiskörner |
0x45 |
|
| 7 | Winterlicher Mischniederschlag | ||
| 18 | Leichter Schneeregen | ||
| 19 | Starker Schneeregen | ||
| 21 | Schneeregen | ||
| 49 | Gefrierender Regen | ||
| 44 | Schneeregen möglich | ||
| 47 | Bewölkt, Regen- und Schneefall möglich | ||
| 34 | Eis | ||
| 51 | Graupel | ||
| 43 | Schneewahrscheinlichkeit |
0x4C |
0x4D |
| 16 | Leichter Schneefall | ||
| 46 | Bewölkt, Schneefall möglich |
0x4A |
|
| 4 | Schnee | ||
| 17 | Starker Schneefall |
0x4B |
|
| 10 | Hagel |
0x3A |
|
Open Weather Map
Sehen Sie sich hier beispielsweise das Icon-Set für OpenWeatherMap an.
| ID | Beschreibung | Tag | Nacht |
|---|---|---|---|
| 2xx | Gewitter | ||
| 200 | Gewitter mit leichtem Regen |
0x36 |
0x37 |
| 201 | Gewitter mit Regen |
0x38 |
|
| 202 | Gewitter mit Starkregen | ||
| 210 | Leichtes Gewitter | ||
| 211 | Gewitter |
0x39 |
|
| 212 | Schweres Gewitter |
0x3B |
|
| 221 | Unregelmäßiges Gewitter | ||
| 230 | Gewitter mit leichtem Nieselregen |
0x3A |
|
| 231 | Gewitter mit Nieselregen | ||
| 232 | Gewitter mit starkem Nieselregen | ||
| 3xx | Nieselregen | ||
| 300 | Leichter Nieselregen |
0x3C |
0x3D |
| 301 | Nieselregen |
0x3E |
|
| 302 | Starker Nieselregen |
0x3F |
|
| 310 | Leichter Nieselregen mit Regen |
0x40 |
|
| 311 | Nieselregen mit Regen | ||
| 312 | Starker Nieselregen mit Regen |
0x41 |
|
| 313 | Regenschauer und Nieselregen | ||
| 314 | Starker Regenschauer und Nieselregen | ||
| 321 | Nieselschauer | ||
| 5xx | Regen | ||
| 500 | Leichter Regen |
0x42 |
|
| 501 | Mäßiger Regen |
0x43 |
|
| 502 | Starkregen |
0x44 |
|
| 503 | Sehr starker Regen | ||
| 504 | Extremer Regen | ||
| 511 | Gefrierender Regen |
0x45 |
|
| 520 | Leichter Regenschauer |
0x46 |
|
| 521 | Regenschauer | ||
| 522 | Starker Regenschauer | ||
| 531 | Unregelmäßiger Regenschauer | ||
| 6xx | Schnee | ||
| 600 | Leichter Schneefall |
0x4C |
0x4D |
| 601 | Schnee |
0x4A |
|
| 602 | Starker Schneefall | ||
| 611 | Eiskörner |
0x45 |
|
| 612 | Leichter Schneeregenschauer | ||
| 613 | Schneeregenschauer | ||
| 615 | Leichter Regen und Schnee | ||
| 616 | Regen und Schnee | ||
| 620 | Leichter Schneeschauer |
0x4B |
|
| 621 | Schneeschauer | ||
| 622 | Starker Schneeschauer | ||
| 7xx | Atmosphäre | ||
| 701 | Leichter Nebel |
0x4E |
|
| 711 | Rauch |
0x4F |
|
| 721 | Dunst | ||
| 731 | Sand-/Staubwirbel | ||
| 741 | Nebel | ||
| 751 | Sand |
0x4F |
|
| 761 | Staub | ||
| 762 | Vulkanasche | ||
| 771 | Böen |
0x52 |
|
| 781 | Tornado |
0x50 |
|
| 800 | Klarer Himmel | ||
| 800 | Klarer Himmel |
0x53 |
0x54 |
| 80x | Bewölkung | ||
| 801 | Leicht bewölkt 11–25% |
0x55 |
0x56 |
| 802 | Aufgelockert bewölkt 25–50% |
0x57 |
0x58 |
| 803 | Stark bewölkt 51–84% |
0x59 |
|
| 804 | Bedeckt 85–100% |
0x5A |
|
QWeather
Die ursprüngliche Sammlung von Wettersymbolen können Sie sich hier ansehen
| ID | Beschreibung | Tag | Nacht |
|---|---|---|---|
| 302 | Gewitterschauer |
0x36 |
0x37 |
| 303 | Starkes Gewitter |
0x38 |
|
| 310 | Starkregen |
0x39 |
|
| 317 | Starkregen bis heftiger Starkregen | ||
| 304 | Hagel |
0x3A |
|
| 311 | Heftiger Starkregen |
0x3B |
|
| 312 | Extremer Starkregen | ||
| 318 | Heftiger bis extremer Starkregen | ||
| 309 | Nieselregen |
0x3C |
0x3D |
| 404 | Eiskörner |
0x3E |
|
| 305 | Leichter Regen |
0x42 |
|
| 314 | Leichter bis mäßiger Regen | ||
| 306 | Mäßiger Regen |
0x43 |
|
| 315 | Mäßiger bis starker Regen | ||
| 399 | Regen | ||
| 308 | Extremer Regen |
0x44 |
|
| 316 | Starker Regen bis Starkregen | ||
| 313 | Gefrierender Regen |
0x45 |
|
| 405 | Regen und Schnee | ||
| 300 | Regenschauer |
0x46 |
|
| 301 | Starker Regenschauer | ||
| 307 | Starker Regen | ||
| 350 | Regenschauer | ||
| 351 | Starker Regenschauer | ||
| 400 | Leichter Schneefall |
0x4C |
0x4D |
| 408 | Leichter bis mäßiger Schneefall | ||
| 499 | Schnee | ||
| 401 | Mäßiger Schneefall |
0x4A |
|
| 402 | Starker Schneefall | ||
| 409 | Mäßiger bis starker Schneefall | ||
| 410 | Starker Schneefall bis Schneesturm | ||
| 403 | Schneesturm |
0x4B |
|
| 406 | Schneeregenschauer | ||
| 407 | Schneegestöber | ||
| 456 | Schneeregenschauer | ||
| 457 | Schneegestöber | ||
| 503 | Sand |
0x4E |
|
| 504 | Staub | ||
| 507 | Staubsturm | ||
| 508 | Sandsturm | ||
| 511 | Mäßiger Dunst | ||
| 512 | Starker Dunst | ||
| 513 | Sehr starker Dunst | ||
| 500 | Leichter Nebel |
0x4F |
|
| 501 | Nebel | ||
| 502 | Dunst | ||
| 509 | Dichter Nebel | ||
| 510 | Starker Nebel | ||
| 514 | Sehr dichter Nebel | ||
| 515 | Extrem dichter Nebel | ||
| 100 | Sonnig |
0x53 |
0x54 |
| 150 | Klarer Himmel | ||
| 101 | Bewölkt |
0x55 |
0x56 |
| 151 | Bewölkt | ||
| 102 | Leicht bewölkt |
0x57 |
0x58 |
| 152 | Leicht bewölkt | ||
| 103 | Teilweise bewölkt |
0x59 |
|
| 153 | Teilweise bewölkt | ||
| 104 | Bedeckt |
0x5A |
|
MET Weather
Sehen Sie sich hier beispielsweise das Icon-Set für MET Weather an.
| ID | Beschreibung | Tag | Nacht |
|---|---|---|---|
| lightrainshowers | Leichte Regenschauer |
0x36 |
0x37 |
| lightrainshowersandthunder | Leichte Regenschauer und Gewitter | ||
| rainshowersandthunder | Regenschauer und Gewitter | ||
| heavyrainshowersandthunder | Heftige Regenschauer und Gewitter | ||
| heavyrainandthunder | Starker Regen und Gewitter |
0x38 |
|
| rainandthunder | Regen und Gewitter | ||
| lightrainandthunder | Leichter Regen und Gewitter |
0x39 |
|
| heavysleetandthunder | Starker Schneeregen und Gewitter |
0x3B |
|
| lightsleetandthunder | Leichter Schneeregen und Gewitter |
0x3A |
|
| lightssleetshowersandthunder | Leichte Schneeregenschauer und Gewitter | ||
| sleetandthunder | Schneeregen und Gewitter | ||
| lightsleetshowers | Leichte Schneeregenschauer |
0x3C |
0x3D |
| sleetshowers | Schneeregenschauer | ||
| sleetshowersandthunder | Schneeregenschauer und Gewitter | ||
| heavysleetshowers | Heftige Schneeregenschauer | ||
| heavysleetshowersandthunder | Heftige Schneeregenschauer und Gewitter | ||
| lightsleet | Leichter Schneeregen |
0x3E |
|
| sleet | Eiskörner |
0x3F |
|
| heavysleet | Starker Schneeregen |
0x45 |
|
| lightrain | Leichter Regen |
0x42 |
|
| rain | Regen |
0x43 |
|
| heavyrain | Starkregen |
0x44 |
|
| rainshowers | Regenschauer |
0x46 |
|
| heavyrainshowers | Starke Regenschauer | ||
| heavysnow | Starker Schneefall |
0x4B |
|
| heavysnowandthunder | Starker Schneefall und Gewitter | ||
| snow | Schnee | ||
| snowandthunder | Schnee und Gewitter | ||
| lightsnowshowers | Leichte Schneeschauer |
0x4C |
0x4D |
| lightssnowshowersandthunder | Leichte Schneeschauer und Gewitter | ||
| snowshowers | Schneeschauer | ||
| snowshowersandthunder | Schneeschauer und Gewitter | ||
| heavysnowshowers | Starke Schneeschauer | ||
| heavysnowshowersandthunder | Heftige Schneeschauer und Gewitter | ||
| lightsnow | Leichter Schneefall |
0x4A |
|
| lightsnowandthunder | Leichter Schneefall und Gewitter | ||
| fog | Nebel |
0x4F |
|
| clearsky | Klarer Himmel |
0x53 |
0x54 |
| fair | Heiter |
0x55 |
0x56 |
| partlycloudy | Wechselnd bewölkt |
0x57 |
0x58 |
| cloudy | Bewölkt |
0x59 |
|