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.
• Entsperrcodes - Automatisch generierte oder von Ihnen heruntergeladene 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

Der Saldo enthält folgende Beträge:

• Bruttobetrag - der Gesamtbetrag aller Zahlungen der Benutzer für den ausgewählten Zeitraum, ohne die Gebühren der Zahlungssysteme und PayToUse.
• Nettobetrag - der Gesamtbetrag aller Zahlungen für den ausgewählten Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse.
• Ausstehender Betrag - der Gesamtbetrag aller Zahlungen für den angegebenen Zeitraum abzüglich der Gebühren der Zahlungssysteme und von PayToUse, die auf das Konto des Entwicklers zur Auszahlung ausstehen. Die Zahlung wird 7 Tage nach der Zahlung zur Auszahlung freigegeben.
• Verfügbarer Betrag - der Gesamtbetrag aller Zahlungen aller Zeiten abzüglich der Gebühren der Zahlungssysteme und von PayToUse, die für die Auszahlung auf das Konto des Entwicklers verfügbar sind.

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, ohne die Gebühren der Zahlungssysteme und 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 Konversionsmetrik bezieht sich auf die Bewertung Ihrer Verkaufseffizienz, um Neue Benutzer in Zahlungen umzuwandeln.

Das Diagramm zeigt das Verhältnis der Anzahl von Zahlungen zur Anzahl von Neue Benutzer in Prozent.

Anwendungen

Wenn Sie zu diesem Abschnitt gehen, ö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. Es kann sein:
• Erstellt - Die Anwendung wurde gerade erstellt, sie ist noch nicht konfiguriert.
• Veröffentlicht - Die Anwendung läuft.
• Erstellt - Das Datum der Anwendungserstellung.
• Zusätzliche Steuerelemente Buttons:
• Löschen - um die Anwendung aus der Liste zu entfernen.

Erstellen oder Bearbeiten einer Anwendung

Um Zahlungen zu akzeptieren, müssen Sie alle erforderlichen Anwendungsdaten konsequent 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 auf dem Dashboard sehen können. Der Name wird im Seitenkopf der gespeicherten Anwendung angezeigt. Solange die Anwendung nicht gespeichert ist, wird anstelle des Namens "Neue App" angezeigt. Das Feld muss eingegeben werden.
• Kontakt-E-Mail - die E-Mail-Adresse, an die Kopien der an Benutzer gesendeten Nachrichten gesendet werden. Diese Adresse ist auch im "Antworten an"-Feld angegeben und wird verwendet, um dem Benutzer auf die mit dem Code empfangene E-Mail zu antworten. Das Feld muss eingegeben werden. Standardmäßig wird das Feld mit dem Wert aus dem Entwicklerprofil gefüllt. Der Wert kann auf einen anderen Wert geändert werden.
• Anwendungstyp - Anwendungstyp. Wenn Sie einen Gruppenanwendungstyp auswählen, wird eine Liste von Anwendungen zur Gruppierung angezeigt. Nur einzelne Anwendungen, für die Entsperrcodes generiert werden, sind in der Liste verfügbar.
• Feedback bei Zahlung erlauben - 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.

Beginnen Sie mit der Eingabe von geänderten Werten und die Schaltfläche Speichern erscheint. Mit der Schaltfläche Speichern können Sie Ihre Änderungen speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

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:

• 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.
• Beschreibung - 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.
• Antwort - 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 im Zahlungsformular angezeigte Sprache wird automatisch auf der Grundlage der vom Benutzer in seinen Browsereinstellungen angegebenen Präferenzen bestimmt. Sie können die Anwendungssprache für die Anwendung speichern.

Beginnen Sie mit der Eingabe oder ändern Sie die Werte und die Schaltfläche Speichern wird angezeigt. Die Schaltfläche Speichern ermöglicht es Ihnen, Ihre Änderungen zu speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

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. Zum Beispiel, wenn Sie 7 Tage angeben, bedeutet dies, dass nach 7 Tagen nach dem ersten API-Aufruf der Anwendung eine Antwort zurückgegeben wird, dass der Testzeitraum abgelaufen ist. Die Zeit des ersten Geräteaufrufs wird gespeichert.
• Preiskalkulationsmethode - Die Methode der Preiskalkulation aus der Liste:
• Preiskalkulation je nach 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.
• Zeitraumberechnung 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.
• Permanentcode - 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.

Der Preis wird in US-Dollar festgelegt. Der Mindestpreis beträgt 1 US-Dollar.

Beginnen Sie mit der Eingabe oder ändern Sie die Werte und die Schaltfläche Speichern wird angezeigt. Die Schaltfläche Speichern ermöglicht es Ihnen, Ihre Änderungen zu speichern, ohne zur nächsten Seite zu gehen. Die Schaltfläche Weiter speichert die Änderungen und wechselt zur nächsten Seite. Sie können jederzeit zurückkehren, um später Änderungen vorzunehmen.

In der Seitenkopfzeile sind nur die gespeicherten Anwendungsseiten zur Navigation verfügbar. Sie können auf Weiter klicken oder zum Abschnitt in der Seitenkopfzeile wechseln.

Vorschau

Diese Seite legt die Werte fest:

• 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.
• Link zum Code überprüfen - 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 wird. 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.

Um Zahlungen zu akzeptieren, müssen Sie die Anwendung mit der Schaltfläche 'Starten' aktivieren. Bevor Sie die Anwendung aktivieren, stellen Sie sicher, dass alle eingegebenen Daten korrekt sind. Die von der Anwendung generierten Schlüssel können nicht geändert werden.

Codeüberprüfung

Die Überprüfung des Anwendungsschlüssels erfolgt in 3 Schritten:

1. Erstellen und Senden einer Anfrage zur Code-Überprüfung
2. Überprüfungen auf der API-Seite
3. 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, // Gerät eindeutiger Bezeichner
			"app" => "6", // Ihre Anwendungs-ID
			"model" => ds.partNumber, // Geräte-Teilenummer
			"code" => Application.Properties.getValue("UnlockCode") // Entsperrcode-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 Entsperrcode.
• 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 ein solcher Rückgabecode gefunden wird, schreiben Sie sofort an Support unter [email protected]

Wenn der Code übergeben wird, werden die folgenden Schritte für Anwendungen mit den Berechnungsmethoden Preiskalkulation je nach Laufzeit und Zeitraumberechnung abhängig vom Preis ausgeführt:

• Wenn ein leerer Code übertragen wird, wird er vom eindeutigen Gerätekennzeichen getrennt, das in den vorherigen Schritten definiert wurde.
• 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 gegen das Gerät geprüft, und wenn ein anderes eindeutiges Gerätekennzeichen als das gespeicherte während der Aktivierung ü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 Permanentcode 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 die vorherigen Überprüfungen nicht bestanden wurden, wird die Testzeit ü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:

{
	"response":101,
	"msg":"Active forever",
	"expires":0
}

{
	"response":101,
	"msg":"Active until 22 Aug 2026",
	"expires":1787433413
}

{
	"response":101,
	"msg":"The code check was successfull",
	"expires":0
}

{
	"response":101,
	"msg":"No code check required",
	"expires":0
}

{
	"response":102,
	"msg":"Trial period expires in 2d 1h 29m",
	"expires":1779662810
}

{
	"response":201,
	"msg":"Code not found"
}

{
	"response":202,
	"msg":"Used on the another device"
}

{
	"response":203,
	"msg":"Expiration: 4 May 2026",
	"expires":1777929413
}

{
	"response":204,
	"msg":"Trial period expired"
}

{
	"response":301,
	"msg":"Application not found"
}

{
	"response":302,
	"msg":"Term undefined"
}

{
	"response":303,
	"msg":"Not enough arguments"
}

{
	"response":304,
	"msg":"Device is nesessary"
}

{
	"response":401,
	"msg":"Error code saving"
}

{
	"response":402,
	"msg":"Error device saving"
}

{
	"response":500,
	"msg":"Unknown error"
}

Ü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 beim API
			// Bezahlte Funktionen sind verfügbar
			...
		}
	}
}

Entsperrcodes

Wenn Sie zu diesem Abschnitt gehen, wird eine Liste der Freischaltcodes geöffnet.

Liste der Freischaltcodes

Sie können das E-Mail-Feld oder den Code in der oberen Suchleiste durchsuchen. Die gefundenen Codes werden in der Liste angezeigt. Sie können das gesamte E-Mail oder den Code oder Teile davon als Suchkriterium verwenden. Übereinstimmungen werden farblich hervorgehoben. Die Suche und die 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.
• Begriff - 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.
• Aktiviert - 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.
• Zahlung # - eindeutige Sequenznummer der Zahlung. Sie können auf den Link klicken, um die Details der Zahlung anzuzeigen.
• Schaltflächen für Aktionen mit Freischaltcodes. Zum Beispiel, Löschung.

Freischaltcode-Status

Während seines Lebenszyklus durchläuft der Freischaltcode verschiedene Zustände, die über den Code-Status verfolgt werden können.

Zahlungen

Wenn Sie zu diesem Abschnitt gehen, 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 zu Streitigkeiten oder Rückerstattungen im Zahlungssystem kommt, werden die Strafen des Zahlungssystems dem Entwickler erneut berechnet. Daher sollten Sie solche Situationen nicht zulassen. Die Gebühr von PayToUse wird in umstrittenen Situationen nicht berechnet.

Liste der Zahlungen

Sie können das E-Mail-Feld oder den gesendeten Code in der oberen Suchleiste suchen. Die gefundenen Zahlungen werden in der Liste angezeigt. Sie können das gesamte oder einen Teil der E-Mail oder des gesendeten Codes 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.
• 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 Statussen 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.
• Begriff - Gültigkeitsdauer des gesendeten Codes (in den Anwendungseinstellungen angegeben).
• 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 Betrag der abgehobenen Gelder für die Zahlung.

Es ist nicht möglich, Änderungen an der Zahlung vorzunehmen.

Zahlungsstatus

Während seines Lebenszyklus durchläuft die Zahlung verschiedene Zustände, die durch den Zahlungsstatus nachverfolgt werden können.

Auszahlungen

Wenn Sie zu diesem Abschnitt gehen, wird eine Liste Ihrer Auszahlungen geöffnet.

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.

Auszahlungsstatus

Während seines Lebenszyklus durchläuft die Auszahlung verschiedene Zustände, die durch den Auszahlungsstatus verfolgt werden können.

API

Übersicht

Die API PayToUse erfüllt folgende Funktionen:

1. Prüft den Aktivierungsstatus eines Entsperrcodes und aktiviert ihn gegebenenfalls.
2. Ruft Blutzuckerdaten aus der NightScout-App ab.
3. 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äte-Kennung
• 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) — Entsperrcode
• 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: Fliesskomma (optional) — Breitengrad
• lon: Fliesskomma (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: Fügen Sie im Abschnitt „Wetter“ Ihrer Anfrage die Option „provider = 1“ hinzu, 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.
• API-Dokumentation: Hier erhältlich.

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 „Wetter“ Ihrer Anfrage „Anbieter = 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: Hier erhältlich.

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 „Wetter“ Ihrer Anfrage „Anbieter = 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 Norwegen ist für seine Umweltdaten bekannt und genießt daher insbesondere in Europa hohes Vertrauen.
• API-Dokumentation: Hier erhältlich.

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 Rückmeldung

Die API gibt ein JSON-Objekt mit Informationen zum Entsperrstatus, zum Blutzuckerspiegel und zum Wetter zurück.

Antwortparameter

Ergebnisse der Entsperrcode-Verifizierung (falls eine Anfrage gesendet wurde):

• response: integer — Rückgabecode
• msg: string — Nachricht über das Verifizierungsergebnis
• 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: Fliesskomma — aktuelle Temperatur in Grad Celsius
• feels_like: Fliesskomma — Gefühlte Temperatur in Celsius
  Внимание! Отсутствует для MET Norway
• pressure: integer — atmosphärischer Druck in hPa
• humidity: integer — Luftfeuchtigkeit in %
• precipitation: integer — Niederschlagswahrscheinlichkeit in %
  Внимание! Отсутствует для MET Norway
• wind: integer — Windrichtung in Grad
• wind_speed: Fliesskomma — Windgeschwindigkeit in m/s
• temp_low: Fliesskomma — Heutige Tiefsttemperatur in Celsius
• temp_high: Fliesskomma — 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 — 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,
		"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
		}
	}
}

Notizen

• Anfragen mit bg erfordern eine Verbindung zur NightScout- App.
• Bei jeder Anfrage mit einem 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.

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.

Open Weather Karte

Sehen Sie sich hier beispielsweise das Icon-Set für OpenWeatherMap an.

QWeather

Die ursprüngliche Sammlung von Wetter-Symbolen kannst du dir hier ansehen

MET Wetter

Sehen Sie sich hier beispielsweise das Icon-Set für MET Weather an.