Manuel

Introduction

La barre latérale gauche contient des liens vers les sections correspondantes :

  • Nom d'utilisateur - liens vers le profil personnel.
  • Tableau de bord - voir l'état actuel sous forme de graphiques et de diagrammes.
  • Applications - gestion des applications.
  • Codes de déverrouillage - codes de déverrouillage générés automatiquement ou importés par vous.
  • Paiements - historique des paiements entrants des utilisateurs.
  • Manuel - le présent manuel utilisateur.

Tableau de bord

Vous pouvez définir des filtres communs pour tous les widgets du tableau de bord :

  • Devise - la devise dans laquelle les montants entrants et sortants seront convertis sur le tableau de bord.
  • Période - est la période pendant laquelle les données sont affichées dans les graphiques et les tableaux sur le tableau de bord. Il détermine l'intervalle pendant lequel les informations et les statistiques sur les paiements, les applications et d'autres paramètres sont analysés et affichés.

Solde

Cette section du tableau de bord présente les principaux indicateurs financiers disponibles pour les retraits. Elle affiche des informations agrégées sur l'ensemble des paiements des utilisateurs, en tenant compte des frais prélevés par les systèmes de paiement et par le service PayToUse.

Les montants suivants apparaissent dans ce bloc :

  • Brut : le montant total de tous les paiements effectués par les utilisateurs pour la période sélectionnée, avant déduction des frais.
  • Net : montant total de tous les paiements effectués au cours de la période sélectionnée, après déduction des frais du système de paiement et des frais de service PayToUse.
  • En attente : montant net des paiements qui ne sont pas encore disponibles pour un retrait. Les fonds deviennent disponibles pour un retrait 7 jours après la date du paiement.
  • Disponible : le montant net total de tous les paiements qui peuvent déjà être retirés sur votre compte. Il s'agit de l'indicateur principal reflétant votre solde disponible réel.

Les paiements Test sont exclus des quatre montants ci-dessus, ainsi que du widget Paiements ci-dessous - ils ne contiennent jamais d'argent réel.

Retirer

Sous l'indicateur du solde disponible se trouve un bouton « Retirer ». Il sert à lancer une demande de transfert des fonds que vous avez gagnés.

Lorsque vous cliquez sur ce bouton, une fenêtre contextuelle s'ouvre dans laquelle vous devez indiquer les détails du paiement pour le virement.

Remarque importante : le système utilise automatiquement la totalité du montant disponible indiqué dans le champ correspondant pour le retrait. Vous ne pouvez pas indiquer un montant arbitraire inférieur au solde disponible. Le montant total du retrait correspond à la somme de tous les paiements dont le statut est « disponible pour retrait ».

Dans la fenêtre contextuelle, vous pouvez sélectionner le montant et la devise du retrait. Les devises disponibles dépendent de vos moyens de paiement.

Remarque : si la devise sélectionnée n'est pas prise en charge par le mode de retrait indiqué, la demande de retrait sera rejetée.

Pour plus d'informations sur le statut et l'historique de vos demandes de retrait, veuillez consulter la section « Retraits ».

Paiements

Le widget Paiements comprend un tableau des paiements regroupés par application pour la période sélectionnée.

Champs de tableau :

  • Application - application. Seules les applications pour lesquelles des paiements ont été effectués pendant la période sélectionnée sont affichées dans le tableau.
  • Paiements - nombre de paiements.
  • Montant brut - le montant total de tous les paiements des utilisateurs pour la période sélectionnée, avant déduction des frais des systèmes de paiement et de PayToUse.
  • Montant net - le montant total de tous les paiements pour la période sélectionnée moins les frais des systèmes de paiement et de PayToUse.

Le graphique montre la dynamique des valeurs Montant net et Montant brut par jour.

Nouveaux utilisateurs

Le graphique des nouveaux utilisateurs montre deux valeurs en dynamique par jour :

  • Nouveaux utilisateurs - le nombre de nouveaux appels API. Les accès à l'API ne sont enregistrés que si le paramètre device - un identifiant unique d'appareil - est passé lors de l'envoi d'une requête à l'API. Ce paramètre doit être vraiment unique pour l'appareil. (voir Envoi d'une demande)
  • Paiements - le nombre de paiements pour la même période par jour.

Conversion

La métrique Conversion mesure l'efficacité avec laquelle vous convertissez Nouveaux utilisateurs en Paiements.

Le graphique montre le rapport entre le nombre de Paiements et le nombre de Nouveaux utilisateurs, en pourcentage.

Applications

Lorsque vous accédez à cette section, une liste de vos applications s'ouvre.

La liste des colonnes dans le tableau des applications :

  • # - identifiant d'application unique. Utilisé lors de la vérification du code d'application ou de l'affichage du formulaire de paiement.
  • Nom - nom de l'application. Le nom n'est affiché que pour vous dans les rapports et le tableau de bord. Un clic sur le nom de l'application ouvre sa page d'édition.
  • Statut - le statut actuel de l'application. Il correspond à l'avancement de l'assistant de configuration. Il peut être :
    • Créé - l'application vient d'être créée, l'étape Application n'est pas encore terminée.
    • Description - l'étape Description n'est pas encore terminée.
    • Prix - l'étape Prix n'est pas encore terminée.
    • Test - toutes les étapes de configuration sont terminées, mais l'application n'a pas encore été lancée. Elle peut être utilisée pour paiements test. Elle n'est pas accessible aux utilisateurs finaux.
    • Lancer - l'application est lancée et accepte des paiements réels.
  • Créé - la date de création de l'application.
  • Boutons de contrôle supplémentaires :
    • Supprimer - pour supprimer l'application de la liste.

Création ou modification d'une application

Pour accepter les paiements, vous devez remplir successivement toutes les données nécessaires de l'application et activer l'application.

Le bouton pour créer une nouvelle application se trouve dans la barre de titre de la liste des applications.

Application

Champs disponibles lors de la création d'une application :

  • Nom - le nom de l'application que vous seul pouvez voir dans les rapports ou sur le tableau de bord. Le nom sera affiché dans l'en-tête de page de l'application enregistrée. Tant que l'application n'est pas enregistrée, « Nouvelle application » est affiché à la place du nom. Champ obligatoire.
  • E-mail de contact - l'adresse e-mail à laquelle sont envoyées les copies des messages adressés aux utilisateurs. Cette adresse est également indiquée dans le champ « Reply-To » : c'est à elle que l'utilisateur répond lorsqu'il répond à l'e-mail contenant le code. Champ obligatoire. Par défaut, le champ est prérempli avec la valeur du profil du développeur ; elle peut être modifiée.
  • Type d'application - type d'application :
    • Unique - une application normale avec son propre formulaire de paiement et ses propres codes de déverrouillage.
    • Groupe avec clé pour une seule application - un seul achat pour plusieurs applications. L'utilisateur paie une fois sur le formulaire de paiement du groupe, et le code peut être activé dans n'importe laquelle des applications du groupe. Après l'activation dans une application, le code devient indisponible dans les autres.
    • Groupe avec clé pour toutes les applications - un seul achat pour plusieurs applications. L'utilisateur paie une fois sur le formulaire de paiement du groupe et reçoit un code qui fonctionne dans toutes les applications du groupe. Dans chaque application, le code est activé et lié à l'appareil séparément. La durée du code est commune : elle est comptée à partir de la première activation dans n'importe quelle application du groupe.
  • Liste des applications du groupe - affichée pour les types de groupe. Sélectionnez une application dans la liste et cliquez sur Ajouter. Au moins deux applications doivent être ajoutées au groupe. Seules vos applications individuelles pour lesquelles des codes de déverrouillage sont générés sont disponibles dans la liste. Une copie du code du groupe est créée pour chaque application du groupe, et dans la liste des codes de déverrouillage ces codes sont affichés sous le code du groupe avec le statut Inconnu.
  • Activer les commentaires pendant le paiement - ajoute un champ au formulaire de paiement pour que les utilisateurs saisissent un texte libre. Les retours sont ajoutés à la copie de l'e-mail du développeur. Les retours peuvent également être consultés dans les détails du paiement.

Les modifications sont enregistrées automatiquement lorsque vous saisissez ou modifiez des valeurs : il n'y a pas de bouton Enregistrer. Un message n'apparaît que si quelque chose n'a pas pu être enregistré. Vous pouvez toujours revenir pour apporter des modifications plus tard.

Passez d'une étape à l'autre dans l'en-tête de la page : il reste en haut lors du défilement. L'étape suivante devient disponible une fois l'étape actuelle remplie ; l'ouvrir enregistre l'étape actuelle.

Description

Sélectionnez une langue dans la liste et cliquez sur Ajouter.

Un onglet avec les textes d'application localisés pour la langue sélectionnée apparaîtra.

Langues disponibles :

  • Allemand
  • Anglais
  • Français
  • Espagnol
  • Russe
  • Chinois simplifié

Les champs de la description sont utilisés pour afficher des informations sur le formulaire de paiement et dans le message de réponse à l'utilisateur :

  • Nom localisé - le nom de l'application pour la langue sélectionnée. Il est affiché sur le formulaire de paiement et dans le courriel de notification de paiement. Par défaut, lors de l'ajout d'une langue, le nom de l'application est inséré. Vous pouvez définir un nom différent pour chaque langue. Champ obligatoire.
  • Description de l'application - une brève description de l'application. Affichée sur le formulaire de paiement sous le nom de l'application. Champ optionnel. Vous pouvez le laisser vide si vous ne souhaitez pas afficher de description.
  • Message de confirmation d'achat - des informations supplémentaires qui seront envoyées à l'utilisateur par courriel lors d'un paiement réussi. Le texte de réponse est ajouté à la fin du courriel après la réponse standard.

Au moins une langue doit être ajoutée pour enregistrer et passer à la page suivante.

La langue du formulaire de paiement est déterminée automatiquement d'après les paramètres du navigateur de l'utilisateur. Marquez l'une des langues avec le bouton radio à côté de son onglet (info-bulle Utiliser par défaut) : ses textes sont affichés lorsque la langue de l'utilisateur ne fait pas partie des langues ajoutées.

Pour supprimer une langue, cliquez sur le bouton de suppression de son onglet et confirmez la suppression.

Les modifications sont enregistrées automatiquement lorsque vous saisissez ou modifiez des valeurs : il n'y a pas de bouton Enregistrer. Un message n'apparaît que si quelque chose n'a pas pu être enregistré. Vous pouvez toujours revenir pour apporter des modifications plus tard.

Passez d'une étape à l'autre dans l'en-tête de la page : il reste en haut lors du défilement. L'étape suivante devient disponible une fois l'étape actuelle remplie ; l'ouvrir enregistre l'étape actuelle.

Prix

La page contient une liste de prix et de champs liés au paiement :

  • Période d'essai - la durée de la période d'essai.
  • Unité de temps - l'unité de temps de la période d'essai. Par exemple, si vous indiquez 7 jours, 7 jours après le premier appel API de l'application, la réponse indiquera que la période d'essai a expiré. L'heure du premier appel de l'appareil est enregistrée.
  • Méthode de calcul du prix - La méthode de calcul du prix dans la liste :
    • Calcul du prix en fonction de la durée - Dans le formulaire de paiement, l'utilisateur spécifie la période d'activation du code, et le prix est automatiquement calculé selon le tableau ci-dessous. L'utilisateur reçoit un code de déverrouillage généré automatiquement dans l'e-mail de réponse.
    • Calcul de la durée en fonction du prix - Dans le formulaire de paiement, l'utilisateur sélectionne un prix dans la liste ou saisit sa propre valeur de prix, et la période est calculée automatiquement selon le tableau ci-dessous. L'utilisateur reçoit un code généré automatiquement dans le message de réponse.
    • Code permanent - Dans le formulaire de paiement, l'utilisateur sélectionne un prix dans la liste ou saisit sa propre valeur de prix. Après paiement, il reçoit un code de la liste ci-dessous, correspondant au prix sélectionné, dans l'e-mail de réponse.
    • Don - Dans le formulaire de paiement, l'utilisateur sélectionne un prix dans la liste ou saisit sa propre valeur de prix. Pour les applications de type Don, aucun code de déverrouillage n'est généré.
    • Code temporaire avec prix dépendant de la durée et Code temporaire avec durée dépendant du prix - l'application reçoit de l'API un code temporaire pour l'appareil et l'affiche à l'utilisateur avec un QR code menant au formulaire de paiement. L'utilisateur paie ce code : le prix dépend de la durée choisie, ou la durée dépend du prix payé, comme dans les méthodes ci-dessus. Après le paiement, le code est activé pour cet appareil uniquement. Un tel code ne peut pas être réinitialisé ni transféré vers un autre appareil.

Pour les applications de groupe, seules les méthodes Calcul du prix en fonction de la durée et Calcul de la durée en fonction du prix sont disponibles. Pour la méthode Don, la période d'essai n'est pas utilisée.

Le tableau Liste de prix définit les niveaux de prix. Ajoutez une ligne avec le bouton Ajouter et supprimez-la avec le bouton Supprimer. Les colonnes du tableau dépendent de la méthode de calcul du prix :

  • Durée, Prix - la durée du code (un nombre et une unité de temps : jours, mois, années ou pour toujours) et son prix.
  • Prix, Code - pour la méthode Code permanent : le prix et le code que l'utilisateur reçoit après l'avoir payé (jusqu'à 12 caractères).
  • Prix - pour la méthode Don : uniquement les montants proposés.

La ligne marquée avec le bouton radio (info-bulle Utiliser par défaut) est présélectionnée sur le formulaire de paiement.

Le prix est fixé en dollars américains. Le prix minimum est de 1 dollar américain.

Les modifications sont enregistrées automatiquement lorsque vous saisissez ou modifiez des valeurs : il n'y a pas de bouton Enregistrer. Un message n'apparaît que si quelque chose n'a pas pu être enregistré. Vous pouvez toujours revenir pour apporter des modifications plus tard.

Passez d'une étape à l'autre dans l'en-tête de la page : il reste en haut lors du défilement. L'étape suivante devient disponible une fois l'étape actuelle remplie ; l'ouvrir enregistre l'étape actuelle.

Aperçu

Cette page définit les valeurs suivantes :

  • Longueur du code - la longueur du code généré, le cas échéant.
  • Ensemble de caractères du code - l'ensemble de caractères à partir duquel le code est généré :
    • Code numérique - le code est généré en utilisant uniquement les chiffres 0, 1, 2, 3, 4, 5, 6, 7, 8, 9. Les zéros initiaux peuvent être inclus dans le code. Les zéros initiaux sont significatifs lors de la vérification du code.
    • Code alphanumérique - le code est généré à partir des caractères 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. Le code est généré et envoyé à l'utilisateur en majuscules. La casse n'a pas d'importance lors de la vérification du code.
  • Autoriser les zéros initiaux dans le code - autorise les zéros initiaux dans le code généré. Disponible uniquement pour le jeu de caractères Code numérique.
  • Autoriser le renvoi du code par identifiant d'appareil - permet de renvoyer le code au même e-mail en répétant la vérification de l'identifiant de l'appareil. Disponible uniquement pour les applications individuelles.
  • Concepteur de cadrans - l'application est un cadran créé dans le concepteur : cette étape affiche le concepteur au lieu du lien de paiement et des exemples de code. Activé pour les cadrans créés depuis la page d'accueil.
  • Date de sortie - la date à laquelle l'application devient disponible pour les utilisateurs habituels. Avec Gratuit pour les testeurs bêta après la sortie, elle définit une période gratuite pour les appareils qui contactent l'application avant cette date.
  • Gratuit pour les testeurs bêta après la sortie - la durée de la période gratuite (dans l'Unité de temps sélectionnée) accordée aux appareils dont le premier appel API a eu lieu avant le Date de sortie. Les codes créés pour ces appareils reçoivent le statut Inconnu.
  • Lien pour vérifier le code - un exemple de lien à utiliser pour la vérification du code.
  • Lien pour payer - lien de paiement. Vous pouvez copier le lien et le coller dans la description de l'application sur le site où elle est publiée. Un lien et un code QR distincts sont générés pour chaque domaine (https://pay-to-use.com pour toutes les langues, https://pay-to-use.ru uniquement pour la langue russe), disponibles sous forme d'onglets au-dessus du champ du lien. Paramètres à passer :
    • app - l'identifiant unique de l'application. Paramètre requis.
    • amount - le montant qui sera indiqué dans le champ de prix lors de l'achat. Le prix par défaut est ignoré. Cependant, le montant ne peut être inférieur ni au prix minimum, ni au prix minimum défini pour l'application. Paramètre facultatif.

Le lien Lien pour payer ne devient accessible publiquement qu'une fois l'application lancée. En attendant, utilisez le bouton Paiement test ci-dessous pour ouvrir le formulaire de paiement avec un jeton d'accès temporaire signé - le même formulaire et les mêmes moyens de paiement que le réel, mais aucun argent n'est réellement débité : un paiement est créé directement avec le statut Test, et un code pleinement fonctionnel (le cas échéant) est généré et envoyé par e-mail immédiatement, sans passer par le système de paiement. Les paiements test sont visibles dans la liste Paiements, marqués du statut Test, mais exclus des totaux du Solde.

Le bouton Paiement test ouvre un menu déroulant pour choisir le domaine (https://pay-to-use.com ou https://pay-to-use.ru) sur lequel ouvrir le formulaire de paiement test - les deux sont tout aussi fonctionnels, le choix n'a d'importance que si vous devez tester un comportement propre à la locale.

Pour commencer à accepter des paiements réels, désactivez Mode test. Avant cela, vérifiez que toutes les données saisies sont correctes. Les clés générées par l'application ne peuvent pas être modifiées. Tant que le mode test est activé, le badge Test s'affiche à côté du nom de l'application. Réactiver Mode test (après confirmation) arrête l'acceptation des paiements réels et rend à nouveau disponible le bouton Paiement test.

Vérification du code

La vérification du code de déverrouillage de l'application se fait en 3 étapes :

  1. Rédaction et envoi d'une demande de vérification du code
  2. Vérifications côté API
  3. Réception et traitement de la réponse de l'API
Envoi d'une demande

Pour vérifier le code, l'utilisateur de votre application doit le saisir dans le champ des paramètres de l'application.

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

Ensuite, vous devez envoyer une demande au serveur API Pay-to-use :

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	return Toybox.Communications.makeWebRequest(
		"https://api.pay-to-use.com", // URL de l'API
		{
			"device" => ds.uniqueIdentifier, // identifiant unique de l'appareil
			"app" => "6", // l'identifiant de votre application
			"model" => ds.partNumber, // référence de l'appareil
			"code" => Application.Properties.getValue("UnlockCode") // valeur du code de déverrouillage dans votre application
		},
		{
			:method => Communications.HTTP_REQUEST_METHOD_POST,
			:headers => { "Content-Type" => Communications.REQUEST_CONTENT_TYPE_JSON },
			:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_JSON
		},
		method(:onReceive)
	);
}

Paramètres de la requête API:

  • url - https://api.pay-to-use.com. L'utilisation du protocole HTTPS est obligatoire.
  • Le corps de la requête (les valeurs transmises). Un dictionnaire de clés et de valeurs :
    • device - identifiant unique de l'appareil.
    • app - identifiant unique de votre application.
    • model - identifiant du modèle d'appareil. Paramètre facultatif. Ces données servent à afficher les statistiques relatives aux nouveaux appareils.
    • code - code de déverrouillage saisi par l'utilisateur dans les paramètres de votre application.
  • Options de la requête :
    • :method - l'API prend en charge les méthodes de requête GET et POST.
    • :headers - pour la méthode POST, les paramètres doivent être transmis au format JSON.
    • :responseType - la réponse est renvoyée au format JSON.
  • responseCallback - une référence vers la méthode de rappel (callback), qui doit accepter deux arguments :
    • responseCode - le code d'en-tête de réponse du serveur.
    • data - le contenu si la requête a réussi, ou null.
Vérifications côté API

Si aucun paramètre n'est transmis à l'API, l'API renvoie un en-tête HTTP/1.1 404 Not Found.

Si au moins un paramètre est transmis à l'API, l'API renvoie l'en-tête HTTP/1.1 200 OK.

La réponse du serveur se compose de :

  • response - code de réponse
  • msg - description textuelle de la réponse
  • expires - horodatage UNIXTIME (si applicable)

Une vérification est effectuée pour s'assurer que l'identifiant de l'application transmis est correct. L'application doit être dans l'état Publié au moment du paiement. En cas d'erreur, le code de réponse 301 est renvoyé.

Si un identifiant d'appareil unique est transmis, l'identifiant d'appareil est recherché et stocké. En cas d'erreurs lors de la vérification ou de l'enregistrement, un code d'erreur 402 est renvoyé. Si vous recevez un tel code de retour, écrivez immédiatement au support à l'adresse [email protected]

Si le code est transmis, les étapes suivantes sont effectuées pour les applications avec les méthodes de calcul Calcul du prix en fonction de la durée et Calcul de la durée en fonction du prix :

  • Si un code vide est transmis, il est détaché de l'identifiant d'appareil unique défini dans les étapes précédentes.
  • Si un code non vide est transmis et n'est pas activé, le code est activé en fonction des conditions de prix spécifiées lors de l'achat du code, indépendamment de la date d'activation.
  • Si aucun code n'a été transmis ou si le code transmis n'est pas trouvé, le code d'erreur 201 est renvoyé.
  • Le code activé est vérifié par rapport à l'appareil et, si un identifiant d'appareil unique autre que celui stocké a été transmis pendant l'activation, un code d'erreur 202 est renvoyé.
  • Si le code transmis n'a pas de date d'expiration et que tous les contrôles précédents ont été réussis, le code 101 est renvoyé.
  • Si le code est limité dans le temps, une vérification est effectuée. Si la clé n'a pas expiré, le code 101 est renvoyé. Si le code a expiré, le code d'erreur 203 est renvoyé.
  • Cette application nécessite que le code soit lié à l'appareil. Si l'ID d'appareil unique n'a pas été transmis, le code d'erreur 304 est renvoyé.

Pour une application avec un Code permanent, seule la disponibilité du code au moment de l'achat est vérifiée. Si un code est trouvé, le code 101 est renvoyé. Si aucun code n'est trouvé, le code d'erreur 201 est renvoyé.

Pour une application avec la méthode de calcul Don, le code n'est pas vérifié. Le code 101 est toujours renvoyé.

Si un code vide est transmis et que le champ Date de sortie de l'application est renseigné, la période de bêta-test est vérifiée : si l'appareil a contacté l'API pour la première fois avant la date de sortie et que la période Gratuit pour les testeurs bêta après la sortie n'est pas encore terminée, le code 103 est renvoyé.

Si l'option Autoriser le renvoi du code par identifiant d'appareil est activée et qu'aucun code n'est transmis, un code valide déjà lié à l'appareil est recherché. S'il est trouvé, le code 101 est renvoyé avec le code lui-même.

Si les contrôles précédents n'ont pas été réussis, la période d'essai est vérifiée. Si, depuis le premier contact de l'appareil, il s'est écoulé plus de temps que ne le prévoient les paramètres actuels de l'application, le code d'erreur 204 est renvoyé. Si la période d'essai n'a pas encore expiré, le code d'erreur 102 est renvoyé.

Si seul l'ID de l'application est transmis et ni le code de déverrouillage ni l'ID d'appareil unique ne sont transmis, le code d'erreur 303 est renvoyé.

Si la réponse retournée est 500, vous devriez écrire au support à l'adresse [email protected]

Ci-dessous se trouve un tableau de tous les codes retournés :

Code Message
101 Méthodes de calcul Calcul du prix en fonction de la durée et Calcul de la durée en fonction du prix :
  • Actif pour toujours
{
	"response":101,
	"msg":"Active forever",
	"expires":0
}
  • Actif jusqu'au [date]
{
	"response":101,
	"msg":"Active until 21 Oct 2027",
	"expires":1824084464
}
Code permanent:
{
	"response":101,
	"msg":"The code check was successfull",
	"expires":0
}
Don:
{
	"response":101,
	"msg":"No code check required",
	"expires":0
}
102
{
	"response":102,
	"msg":"Trial period expires in 2d 4h 55m",
	"expires":1795244616
}
103
{
	"response":103,
	"msg":"Free for beta tester until 10 Jan 2027",
	"expires":1799546864
}
201
{
	"response":201,
	"msg":"Code not found"
}
202
{
	"response":202,
	"msg":"Used on the another device"
}
203
{
	"response":203,
	"msg":"Expiration: 20 Oct 2026",
	"expires":1792462064
}
204
{
	"response":204,
	"msg":"Trial period expired"
}
301
{
	"response":301,
	"msg":"Application not found"
}
302
{
	"response":302,
	"msg":"Term undefined"
}
303
{
	"response":303,
	"msg":"Not enough arguments"
}
304
{
	"response":304,
	"msg":"Device is nesessary"
}
401
{
	"response":401,
	"msg":"Error code saving"
}
402
{
	"response":402,
	"msg":"Error device saving"
}
500
{
	"response":500,
	"msg":"Unknown error"
}
Vérification de la réponse

Ensuite, vous devez vérifier la réponse du serveur API Pay-to-use :

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

Vous pouvez vérifier tous les en-têtes et les codes, vous pouvez afficher vos propres messages pour la commodité de l'utilisateur, mais de la manière la plus simple, la vérification ressemblera à ceci :

/source/app.mc
function onBackgroundData(data) as Void {
	if (data.hasKey("response")) {
		if (data.hasKey("msg")) {
			// Vous pouvez afficher data["msg"] dans le champ de propriétés avec le nom "UnlockResult".
			Application.Properties.setValue("UnlockResult", data["msg"]);
		}
		if (data["response"].toString().substring(0, 1).equals("2")) {
			// La vérification du code a échoué
			// Les fonctions payantes ne sont PAS disponibles
			...
		} else {
			// La vérification du code a réussi, ou l'erreur vient de vous ou de l'API
			// Les fonctions payantes sont disponibles
			...
		}
	}
}

Codes de déverrouillage

Lorsque vous accédez à cette section, une liste de codes de déverrouillage s'ouvrira.

Liste des codes de déverrouillage

Vous pouvez rechercher le champ d'e-mail ou le code dans la barre de recherche en haut. Les codes trouvés seront affichés dans la liste. Vous pouvez utiliser tout ou partie de l'e-mail ou du code comme critère de recherche. Les correspondances seront surlignées en couleur. La recherche et les filtres fonctionnent simultanément et ne s'excluent pas mutuellement.

Le dernier filtre utilisé est enregistré pour l'utilisateur. Ainsi, la prochaine fois que vous accéderez à la page, le dernier filtre utilisé sera appliqué automatiquement. Les filtres sont disponibles pour la liste des codes de déverrouillage :

  • Colonnes - sélectionnez les colonnes du tableau à afficher dans la liste des codes de déverrouillage.
  • Application - afficher uniquement les codes de déverrouillage pour les applications sélectionnées.
  • Statut - afficher uniquement les codes de déverrouillage qui sont dans les statuts sélectionnés.

La liste des colonnes dans le tableau des codes de déverrouillage :

  • Application - votre application. Vous pouvez suivre le lien pour modifier ses paramètres.
  • Code - le code de déverrouillage.
  • E-mail - l'adresse e-mail associée à l'enregistrement du code de déverrouillage. Cette adresse est utilisée pour rechercher les codes de déverrouillage client dans la section Mes achats du site Web. Cette section est accessible aux utilisateurs.
  • Durée - la période de validité du code envoyé (spécifiée dans les paramètres de l'application). Une période de validité est définie pour le code, correspondant aux conditions des paramètres de l'application au moment de sa création.
  • Statut - le statut du code de déverrouillage. (voir Statut du code de déverrouillage)
  • Créé - la date de création du code de déverrouillage.
  • Langue - la langue de l'utilisateur, utilisée pour les messages contenant le code.
  • Activation - la date d'activation du code. Elle est définie au moment où cet appareil de l'utilisateur contacte pour la première fois le service d'API PayToUse et soumet ce code. Le statut du code passe à Activé. Seul un code inactif peut être activé. Si un code actif est soumis par un appareil avec un identifiant différent, l'API renvoie l'erreur 202. Un seul appareil peut être lié à un seul code.
  • Expiration - la date d'expiration de l'activation du code. Définie pour les codes qui ont une période de validité limitée à l'activation du code. Pour les codes avec une date d'expiration illimitée, la case reste vide.
  • Supprimé - la date de suppression du code. Lors de la suppression, le statut du code est défini sur Inconnu.
  • Appareil - l'identifiant unique de l'appareil auquel le code est lié.
  • Premier accès de l'appareil - la date du premier appel à l'API depuis l'appareil. La période d'essai et la période de bêta-test sont comptées à partir de cette date.
  • Dernier accès de l'appareil - la date du dernier appel à l'API depuis l'appareil. Permet de vérifier si l'application est toujours utilisée.
  • Paiement # - numéro de séquence unique du paiement. Vous pouvez cliquer sur le lien pour afficher les détails du paiement.
  • Notes - notes saisies lors de la création manuelle des codes.
  • Boutons pour les actions sur les codes de déverrouillage. Par exemple, la suppression.

Statut du code de déverrouillage

Pendant son cycle de vie, le code de déverrouillage passe par différents états, qui peuvent être suivis par le statut du code.

Statut Description
Disponible Le statut est attribué à un code de déverrouillage pour lequel aucune action n'a été effectuée ou si le lien de l'appareil est réinitialisé pour le code.
Activé Le statut est défini pour un code avec une date d'activation définie. La date d'activation est définie lorsque l'appareil accède avec succès au service API PayToUse pour la première fois. De plus, lors de l'activation du code, la date d'expiration du code est définie.
Expiré Le statut est défini pour un code expiré. Détacher le code de l'appareil ne réinitialise pas la date d'expiration du code. Vérifier le code avec ce statut renverra l'erreur 203. (voir Vérifications côté API)
Inconnu Le statut est défini lorsque le code est supprimé. Vérifier le code avec ce statut renverra l'erreur 201. (voir Vérifications côté API)
Inconnu Le statut est attribué à un code créé pour un appareil dont le premier appel API a eu lieu avant la Date de sortie de l'application - une période gratuite lui est accordée à la place de l'essai habituel ou de l'activation payante, selon la configuration de Gratuit pour les testeurs bêta après la sortie.
Inconnu Le statut est attribué à un code partagé par plusieurs applications regroupées. Il n'est pas lié à une seule application et n'apparaît pas dans la liste des codes des applications individuelles du groupe.
Inconnu Comme Inconnu, mais le code n'est plus disponible : il a été supprimé ou, pour un groupe avec une clé pour une seule application, il a déjà été activé dans l'une des applications du groupe. La suppression du code du groupe supprime également ses copies dans toutes les applications du groupe.
Inconnu Le statut est attribué à un code appartenant à une application au sein d'un groupe lorsqu'il est supprimé individuellement, alors que le code du groupe lui-même reste.

Détails du code

Un clic sur le code dans la liste ouvre la page de détails du code. Elle affiche les mêmes champs que la liste ainsi que des boutons pour les actions sur le code :

  • Réinitialiser - détache le code de l'appareil et réinitialise la date d'activation. Le statut du code passe à Disponible, et le code peut être activé sur un autre appareil, par exemple lorsque l'utilisateur a changé d'appareil. La date d'expiration d'un code déjà activé n'est pas réinitialisée. Le bouton n'est pas disponible pour les applications avec des codes temporaires, car un tel code ne peut être utilisé que sur un seul appareil.
  • Activer - disponible pour un code temporaire qui n'a pas encore été payé. Saisissez l'e-mail de l'utilisateur et la durée du code : le code est activé pour l'appareil auquel il est lié, comme s'il avait été payé. Utilisez-le, par exemple, pour offrir l'application gratuitement à l'utilisateur.
  • Envoyer le code - envoie un e-mail avec le code et ses détails à l'e-mail du code. Sélectionnez la Langue du message. Si Envoyer une copie au développeur est coché, une copie de l'e-mail est envoyée à l'e-mail de contact de l'application. Utilisez-le lorsque l'utilisateur a perdu l'e-mail contenant le code.
  • Changer l'e-mail - modifie l'e-mail du code. Pour un code de groupe, l'e-mail est modifié pour le code du groupe et toutes ses copies. Si le code a été obtenu à la suite d'un paiement, l'e-mail du paiement est également modifié. L'utilisateur trouvera ensuite le code dans la section Mes achats avec le nouvel e-mail.
  • Supprimer - supprime le code. Le statut du code passe à Inconnu, et la vérification du code renvoie l'erreur 201. Un code temporaire non payé est entièrement supprimé.

Les actions sur le code sont également disponibles sur la page de détails du paiement si un code a été envoyé pour le paiement.

Créer

Le bouton Créer dans la barre de titre de la liste des codes de déverrouillage ouvre le formulaire de création de codes sans paiement. Par exemple, pour des bêta-testeurs, des critiques ou des utilisateurs ayant payé autrement. Champs du formulaire :

  • E-mail - l'adresse à laquelle les codes créés sont envoyés. Une copie de l'e-mail est envoyée à l'e-mail de contact de l'application.
  • Application - l'application pour laquelle les codes sont créés. Seules les applications aux statuts Test et Lancer avec la méthode de calcul du prix Calcul du prix en fonction de la durée ou Calcul de la durée en fonction du prix sont disponibles.
  • Durée et Unité de temps - la durée de validité des codes. Elle est comptée à partir de l'activation du code sur l'appareil.
  • Nombre - le nombre de codes à créer.
  • Notes - texte libre enregistré avec les codes. Affiché dans la colonne Notes de la liste.
  • Inclure les notes dans l'e-mail - ajoute les notes à l'e-mail contenant les codes.

Les codes sont générés selon les paramètres de code de l'application (longueur et jeu de caractères). Après l'enregistrement, la liste des codes créés s'affiche et l'e-mail est envoyé.

Importer

Le bouton Importer permet de charger des codes émis en dehors de PayToUse, par exemple lors de la migration depuis un autre système de licences. Sélectionnez l'application, le fichier et les paramètres du fichier :

  • Format de fichier - CSV, encodage UTF-8. La taille maximale du fichier est indiquée dans le formulaire de chargement.
  • contient des en-têtes - cochez si la première ligne du fichier contient les noms des colonnes. La première ligne est alors ignorée.
  • Délimiteur - point-virgule, virgule ou tabulation.

Colonnes du fichier, dans cet ordre :

  1. Code - le code de déverrouillage, obligatoire. Converti en majuscules et tronqué à 12 caractères. Les codes qui existent déjà pour l'application sont ignorés.
  2. E-mail - l'e-mail de l'utilisateur.
  3. Créé - la date de création : une date ou un horodatage UNIXTIME. Si vide, la date du chargement est utilisée.
  4. Expiration - la date d'expiration : une date ou un horodatage UNIXTIME. Laissez vide si le code n'a pas encore été activé ou n'a pas de date d'expiration.
  5. Durée - la durée de validité après activation : un nombre et une unité, par exemple 12h, 30d, 6m ou 1y. Si vide, le code est valable pour toujours.

Après le chargement, le tableau des lignes chargées s'affiche. Les lignes non chargées sont surlignées en rouge, et un message indique combien de lignes ont été insérées sur le total. Aucun e-mail n'est envoyé aux utilisateurs lors du chargement.

Télécharger

Le bouton Télécharger télécharge la liste des codes de déverrouillage dans un fichier CSV. Dans le formulaire, sélectionnez les champs à inclure dans le fichier. Le fichier contient tous les codes correspondant aux filtres et à la recherche actuels, pas seulement ceux de la page courante. Les champs sélectionnés sont mémorisés pour le prochain téléchargement.

Paiements

En accédant à cette section, une liste des paiements des utilisateurs s'ouvrira.

Les systèmes de paiement suivants sont utilisés pour recevoir des paiements :

Système Description
Les frais du système de paiement sont à partir de 2,9% + 0,30 USD par débit de carte réussi. Les cartes, les portefeuilles et d'autres options de paiement sont pris en charge. Les frais dépendent du mode de paiement et peuvent différer des frais de paiement par carte. Vous trouverez des informations détaillées sur les frais du système de paiement sur son site Web.
Les frais du système de paiement sont à partir de 3,4% + 0,30 USD par paiement réussi. Les cartes et PayPal sont pris en charge. Vous trouverez des informations détaillées sur les frais du système de paiement sur son site Web.
Les frais du système de paiement sont à partir de 3,9% par paiement réussi. Les cartes et d'autres options de paiement sont prises en charge. Les frais dépendent du mode de paiement. Vous trouverez des informations détaillées sur les frais du système de paiement sur son site Web.

Après les frais du système de paiement, PayToUse facturera des frais de 13%. Nous travaillons constamment à réduire les frais.

Si des litiges ou des remboursements surviennent dans le système de paiement, les pénalités du système de paiement sont répercutées sur le développeur. Vous devez donc éviter de telles situations. Les frais PayToUse ne sont pas facturés en cas de litige.

Liste des paiements

Vous pouvez rechercher le champ d'e-mail ou le code envoyé dans la barre de recherche en haut. Les paiements trouvés seront affichés dans la liste. Vous pouvez utiliser tout ou partie de l'e-mail ou du code envoyé comme critère de recherche. Les correspondances seront mises en surbrillance en couleur. La recherche et les filtres fonctionnent simultanément et ne s'excluent pas mutuellement.

Le dernier filtre utilisé est enregistré pour l'utilisateur. Ainsi, la prochaine fois que vous accéderez à la page, le dernier filtre utilisé sera appliqué automatiquement. Des filtres sont disponibles pour la liste des paiements :

  • Colonnes - sélectionnez les colonnes du tableau à afficher dans la liste de paiements.
  • Période - afficher uniquement les paiements créés dans la plage de dates sélectionnée.
  • Application - affichage des paiements uniquement pour les applications sélectionnées.
  • Système - afficher les paiements uniquement à partir des systèmes de paiement sélectionnés.
  • Statut - afficher les paiements uniquement avec les statuts sélectionnés.

La liste des colonnes dans le tableau des paiements :

  • Application - votre application. Vous pouvez suivre le lien pour modifier ses paramètres.
  • # - numéro de séquence unique du paiement. Il est attribué au paiement automatiquement lorsque l'utilisateur passe du formulaire de paiement à la page de paiement dans le système de paiement. Vous pouvez cliquer sur le lien pour afficher les détails du paiement.
  • Commentaires - message de l'utilisateur saisi dans le formulaire de paiement.
  • Système - le système de paiement sélectionné par l'utilisateur.
  • Statut - le statut du paiement. (voir Statut du paiement)
  • E-mail - e-mail de l'utilisateur indiqué dans le formulaire de paiement.
  • Durée - la période de validité du code envoyé (spécifiée dans les paramètres de l'application).
  • Langue - la langue du formulaire de paiement choisie par l'utilisateur.
  • Créé - la date de création du paiement.
  • Montant de la facture - le montant du paiement facturé à l'utilisateur. Spécifié dans le formulaire de paiement en fonction des paramètres de l'application.
  • Date de paiement - la date du paiement.
  • Montant du paiement - le montant du paiement confirmé par le système de paiement.
  • Code envoyé - code envoyé à l'utilisateur.
  • Montant disponible - montant de retrait disponible.
  • Montant du versement - le montant des fonds retirés pour le paiement.

Détails du paiement

Cliquer sur le # d'un paiement dans la liste ouvre sa page de détails.

En plus des champs déjà listés ci-dessus, la page de détails affiche :

  • Code - le code saisi par l'acheteur sur le formulaire de paiement, avant sa vérification et son activation. Affiché uniquement pour les applications avec des codes temporaires liés à un appareil.
  • Montant du paiement (Brut) - le montant confirmé par le système de paiement, avant les frais du système de paiement et de PayToUse.
  • Montant du paiement (Net) - le montant confirmé par le système de paiement, après les frais du système de paiement et de PayToUse.
  • Identifiants de paiement - identifiants attribués par le système de paiement, utilisés pour retrouver le paiement si nécessaire. Les champs affichés dépendent du système de paiement :
    • Stripe: Payment Intent, Reçu #, 4 derniers chiffres.
    • PayPal: ID de paiement, ID du payeur, ID de transaction.
    • Robokassa: ID de paiement, ID1, ID2.

Si un code a été envoyé pour le paiement, les boutons Réinitialiser le code, Envoyer le code et Changer l'e-mail sont disponibles sur la page de détails du paiement. Ils fonctionnent de la même manière que sur la page de détails du code. (voir Détails du code)

Statut du paiement

Durant son cycle de vie, le paiement passe par différents états, qui peuvent être suivis par le statut du paiement.

Statut Description
Incomplet Le statut est attribué aux paiements pour lesquels aucune action n'a été effectuée. Le paiement est créé dès que l'utilisateur passe du formulaire de paiement au formulaire de système de paiement. Le paiement se voit attribuer un numéro de série unique, ainsi que les attributs de base du paiement : montant, système de paiement, date.
Réussi Le statut est attribué aux paiements qui ont reçu une réponse positive du système de paiement. L'étape suivante consiste à envoyer un e-mail à l'utilisateur contenant le code généré ou d'autres données en fonction des paramètres de l'application. Si le paiement reste dans ce statut, il est nécessaire d'y prêter une attention particulière, car les actions ultérieures n'ont pas été effectuées.
Erreur Le statut est attribué aux paiements pour lesquels une réponse négative est reçue du système de paiement. Les étapes suivantes ne sont pas effectuées. Il est nécessaire de porter une attention particulière à de tels paiements, car le statut du côté du système de paiement peut être traité avec un certain délai.
En attente Le statut est attribué aux paiements pour lesquels une réponse positive a été reçue du système de paiement et dont toutes les étapes ultérieures ont été effectuées avec succès. Le retrait n'est pas disponible pour les paiements ayant ce statut. Les paiements passent automatiquement au statut suivant au bout de 7 jours.
Disponible Le retrait est disponible pour les paiements dans ce statut.
Envoi Le statut est attribué aux paiements inclus dans le prochain retrait. Si le retrait est annulé ou refusé, le paiement revient au statut Disponible.
Envoyé Le statut est attribué aux paiements pour lesquels le retrait a été effectué. La confirmation de la réception des fonds est en attente.
Terminé Le statut est attribué aux paiements dont le retrait a réussi. Vous pouvez définir ce statut manuellement en confirmant le retrait dans la section correspondante. Le statut change également automatiquement 14 jours après le retrait du paiement.
Remboursé Les paiements pour lesquels un remboursement a été émis sont transférés dans ce statut. Lors de l'émission d'un remboursement, des frais de remboursement sont facturés. Les frais sont déduits du montant du retrait.
Remboursement clos Un remboursement inclus dans un retrait déjà envoyé. Les frais de remboursement sont à la place déduits du solde du développeur, car le montant retiré ne peut plus être réduit.
Litige L'acheteur a contesté (rétrofacturation) le paiement auprès du système de paiement. Le résultat est en attente.
Litige clos Le litige a été résolu. Comme pour un remboursement, tous les frais de litige facturés par le système de paiement sont répercutés sur le développeur.
Annulé Le paiement a été annulé avant d'être finalisé.
Inconnu Attribué lors du rapprochement des enregistrements de paiement avec un rapport du système de paiement dont le texte de statut ne correspond à aucun des statuts connus ci-dessus. Nécessite une vérification manuelle.
Test Un paiement test effectué via le Mode test de l'application alors qu'elle est au statut Test, avant son lancement. Le montant et tout code généré sont réels, mais aucun argent n'est réellement débité et le paiement est exclu des totaux du tableau de bord.

Télécharger

Le bouton Télécharger dans la barre de titre de la liste des paiements télécharge la liste dans un fichier Excel (XLSX). Le fichier contient les colonnes sélectionnées dans le filtre Colonnes, dans le même ordre, et tous les paiements correspondant aux filtres et à la recherche actuels, pas seulement ceux de la page courante.

Retraits

Lorsque vous accédez à cette section, une liste de vos retraits s'ouvrira.

Retirer

Le bouton « Retirer » permet de lancer une demande de transfert des fonds que vous avez gagnés.

Lorsque vous cliquez sur ce bouton, une fenêtre contextuelle s'ouvre dans laquelle vous devez indiquer les détails du paiement pour le virement.

Remarque importante : le système utilise automatiquement la totalité du montant disponible indiqué dans le champ correspondant pour le retrait. Vous ne pouvez pas indiquer un montant arbitraire inférieur au solde disponible. Le montant total du retrait correspond à la somme de tous les paiements dont le statut est « disponible pour retrait ».

Dans la fenêtre contextuelle, vous pouvez sélectionner le montant et la devise du retrait. Les devises disponibles dépendent de vos moyens de paiement.

Remarque : si la devise sélectionnée n'est pas prise en charge par le mode de retrait indiqué, la demande de retrait sera rejetée.

Liste des retraits

Le dernier filtre utilisé est stocké pour l'utilisateur. Ainsi, la prochaine fois que vous accéderez à la page, le dernier filtre utilisé sera appliqué automatiquement. Des filtres sont disponibles pour la liste des retraits :

  • Colonnes - n'afficher que les colonnes sélectionnées dans la liste des retraits.
  • Statut - n'afficher que les retraits qui sont dans les statuts sélectionnés.

La liste des colonnes dans le tableau des retraits :

  • # - numéro de séquence unique du retrait. Il est attribué au retrait automatiquement lors de l'enregistrement du retrait. Vous pouvez cliquer sur le lien pour afficher les détails du retrait.
  • Statut - le statut du retrait. (voir Statut du retrait)
  • Créé - la date de la demande de retrait.
  • Montant - le montant du retrait.
  • Retrait - la date à laquelle le retrait a été envoyé.
  • Boutons pour les actions concernant les retraits. Par exemple, confirmation.

Vous pouvez confirmer le retrait lorsqu'il est dans le statut Envoyé.

Détails du retrait

Un clic sur le # d'un retrait dans la liste ouvre sa page de détails. En plus des champs de la liste, elle affiche les Détails - les coordonnées de paiement indiquées dans la demande de retrait, vers lesquelles les fonds sont virés.

Ci-dessous, la liste des paiements inclus dans le retrait. Les filtres Colonnes, Application, Système et Statut sont disponibles, comme dans la liste des paiements. (voir Liste des paiements)

Statut du retrait

Durant son cycle de vie, le retrait passe par différents états, qui peuvent être suivis par le statut du retrait.

Statut Description
En attente Le statut est attribué aux retraits lors de leur création, tant qu'aucune action n'a été effectuée.
Annulé Le statut est attribué aux retraits annulés. Les annulations peuvent être effectuées pour diverses raisons. Par exemple, la méthode de réception des fonds n'est pas spécifiée. Tous les paiements de ce retrait passent au statut Disponible et sont à nouveau disponibles pour un retrait.
Envoyé Le statut est défini pour le retrait des fonds lorsqu'il est envoyé.
Terminé Le statut est défini pour un retrait manuel lorsque le développeur confirme la réception des fonds, ou automatiquement 14 jours après l'envoi.
Refusé Le statut est défini pour le retrait lorsque la banque ou le système de paiement retourne les fonds après l'envoi. Tous les paiements de ce retrait passent au statut Disponible et sont à nouveau disponibles pour un retrait.

Concepteur de cadrans

Le concepteur crée des cadrans Garmin Connect IQ pour votre application sans programmation. Vous placez des éléments sur l'écran de chaque modèle de montre, choisissez ce qu'ils affichent et lesquels sont payants, puis téléchargez un fichier prêt : .prg à installer sur votre propre montre pour tester ou .iq à publier dans le Connect IQ Store.

Le cadran terminé vérifie lui-même le paiement via PayToUse, selon le mode de paiement de l'application. Vous n'avez pas besoin d'écrire de code.

Le concepteur s'ouvre avec le bouton en forme de fusée à côté du nom de l'application sur la page de l'application.

Clé de développeur Connect IQ

Chaque fichier .prg et .iq est signé avec la clé de développeur, une clé privée RSA de 4096 bits. Elle est définie une fois dans le Profil et utilisée pour tous les cadrans du développeur.

  • Si vous avez déjà des applications dans le Connect IQ Store, téléversez la clé avec laquelle vous les avez signées : le fichier developer_key créé par le Connect IQ SDK (par exemple avec la commande "Monkey C: Generate a Developer Key" dans Visual Studio Code). Une application publiée dans le store ne peut être mise à jour qu'avec la même clé.
  • Si vous n'avez pas encore de clé, générez-la avec le bouton « Générer une nouvelle clé ». Une telle clé convient pour installer des cadrans sur votre montre et pour de nouvelles applications dans le store, mais les applications déjà publiées avec une autre clé ne peuvent pas être mises à jour avec elle.
  • Téléchargez la clé et conservez-en une copie en lieu sûr. Si la clé est perdue, les applications publiées avec elle ne pourront plus être mises à jour dans le store.
  • Les fichiers au format DER ou PEM sont acceptés. La clé ne doit pas être protégée par un mot de passe.

Important : le remplacement de la clé concerne tous les cadrans du développeur. L'ancienne clé est conservée sur le serveur, mais les nouvelles compilations sont signées avec la nouvelle.

Modèles de montres

La liste des modèles disponibles dans le concepteur est définie par l'administrateur sur la page Modèles de montres : modèles ronds et rectangulaires avec Connect IQ 4 et plus récent. Dans le concepteur, choisissez les modèles du cadran avec le bouton Modèles.

Chaque modèle a sa propre disposition : la position, la taille et la police des éléments sont définies séparément, tandis que la liste des éléments, les fonctions et les réglages de paiement sont communs à tous les modèles. Un nouveau modèle reçoit la disposition du modèle actuel adaptée à son écran.

  • Montre / Écran - afficher l'écran sur l'image de la montre ou seulement l'écran.
  • Taille réelle - afficher la montre à sa taille réelle.
  • Always On - aperçu du mode Always On des écrans AMOLED.

Éléments

Un cadran se compose d'éléments de quatre types :

  • Texte - affiche la valeur d'une fonction : heure, date, pas, fréquence cardiaque, météo, etc.
  • Texte fixe - texte que vous saisissez vous-même.
  • Aiguilles - aiguilles analogiques des heures, des minutes et des secondes.
  • Image - une image : arrière-plan ou calque au-dessus des autres éléments.

Les éléments sont dessinés dans l'ordre de la liste de l'onglet Éléments : le premier est le calque du bas. L'ordre se modifie avec les flèches de la liste et les boutons À l'arrière-plan et Au premier plan.

Les éléments se déplacent avec la souris ou les flèches du clavier (1 px, avec Maj 10 px). Ctrl+D duplique l'élément, Ctrl+C / Ctrl+V copient sa position vers un autre modèle, Suppr le supprime. Le bouton Copier vers tous les modèles transfère la position de l'élément à tous les modèles sélectionnés. Le bouton Tout copier vers tous les modèles remplace les mises en page de tous les autres modèles par celle du modèle actuel : tous les éléments et le fond, mis à l’échelle de chaque écran.

Fonctions et paiement

Un élément texte peut avoir plusieurs fonctions. L'une d'elles est affichée par défaut ; si L'utilisateur peut choisir la fonction dans les réglages est activé, l'utilisateur de la montre choisit la fonction dans les réglages du cadran dans Garmin Connect.

Chaque fonction de chaque élément peut être marquée comme payante : une même fonction peut être gratuite dans un élément et payante dans un autre. L'onglet Fonctions affiche toutes les fonctions et tous les éléments utilisés dans un tableau.

Les fonctions marquées d'un astérisque nécessitent une autorisation supplémentaire (historique des capteurs, profil utilisateur ou position), que le store affiche lors de l'installation du cadran. L'autorisation n'est ajoutée au cadran que s'il utilise de telles fonctions. Le lever et le coucher du soleil, ainsi que les icônes jour/nuit, ont besoin de la position : la dernière position GPS de la montre (mise à jour par toute activité avec GPS), sinon le lieu de la prévision météo.

Sans paiement, le cadran se comporte selon le mode de paiement de l'application :

Mode de paiement Sans paiement
Calcul du prix en fonction de la durée, Calcul de la durée en fonction du prix, Code permanent Les fonctions payantes affichent « paid », les images payantes sont masquées. Le code de déverrouillage se saisit dans les réglages du cadran ; le code QR de la page d'achat se trouve dans le menu des réglages de la montre.
Code temporaire avec prix dépendant de la durée, Code temporaire avec durée dépendant du prix Si le cadran utilise des fonctions payantes, il affiche un écran de verrouillage avec le code de la montre et le code QR de la page de paiement.
Don Il n'y a pas de vérification de paiement, les marques payantes sont ignorées.

Sur les écrans tactiles, toucher un cadran verrouillé ouvre toutes les fonctions pendant 15 minutes à titre d'essai.

Icônes

Un élément de texte peut afficher une icône à côté de la valeur de la fonction. L'icône appartient à la fonction dans tout le cadran : elle se modifie dans la colonne Icône du tableau des fonctions d'un élément ou dans l'onglet Fonctions, et la modification s'applique à tous les éléments ayant cette fonction.

  • Du dictionnaire (par défaut) : l'icône que l'administrateur a définie pour cette fonction dans le dictionnaire d'icônes.
  • Aucune icône : la fonction s'affiche sans icône.
  • Une icône : n'importe quelle icône de la bibliothèque commune ou de vos propres icônes.
  • Jeu : l'icône dépend de la valeur de la fonction : la première ligne dont la valeur « jusqu'à » n'est pas inférieure à la valeur est utilisée, la dernière ligne sert pour toutes les valeurs supérieures. Avec « Jour / nuit », chaque ligne a sa propre icône de nuit, utilisée entre le coucher et le lever du soleil.

Valeurs pour les jeux : batterie - charge en %, alarmes - leur nombre, connexion du téléphone et ne pas déranger - 1 ou 0, lune - âge en jours, vent - direction en degrés, météo - code d'état ; autres fonctions - leur nombre sans unité. Pendant la charge de la batterie, les icônes de batterie s'affichent à tour de rôle.

Le réglage Afficher d'un élément choisit le texte et l'icône, le texte seul ou l'icône seule. La position de l'icône par rapport au texte, sa taille, sa couleur, l'espacement et le décalage se règlent dans la disposition de chaque modèle. L'alignement de l'élément s'applique à l'ensemble du bloc : texte, espacement et icône réunis.

Vos propres icônes s'ajoutent dans l'onglet Cadran, section Icônes du cadran : des fichiers SVG (plusieurs à la fois) ou une police TTF dont chaque caractère devient une icône. Exigences pour les SVG :

  • les icônes sont monochromes : les couleurs du fichier sont ignorées, l'icône est dessinée avec la couleur choisie dans le concepteur ;
  • seules les formes remplies sont utilisées ; les lignes sans remplissage (stroke) doivent être converties en formes dans un éditeur vectoriel (par exemple « Contour en chemin » dans Inkscape ou « Outline Stroke » dans Figma et Illustrator) ;
  • les trous doivent être de vraies découpes (chemin composé ou règle de remplissage evenodd) : une forme blanche sur une forme noire devient une zone remplie ;
  • la taille de l'icône est le viewBox du fichier ; les dégradés, masques, textes et classes CSS ne sont pas pris en charge.

Sur la montre, les icônes sont converties en images bitmap de la taille nécessaire lors de la compilation du cadran.

Polices et images

  • Les polices système de la montre sont disponibles pour chaque modèle. Les polices numériques ne contiennent que des chiffres et quelques symboles.
  • Vos propres polices TTF ou OTF se téléversent dans l'onglet Cadran et sont converties en bitmaps pour chaque modèle et chaque taille. Un modèle peut avoir jusqu'à 12 tailles différentes de polices et d'icônes propres au total.
  • Les images (PNG, JPEG, GIF, WebP jusqu'à 2000×2000) sont téléversées dans le même onglet. Une image remplit l'écran de n'importe quel modèle ou a sa propre taille ; elle est redimensionnée pour chaque modèle, la transparence est conservée. Jusqu'à 8 images ou tailles différentes par modèle.
  • Les images occupent la mémoire graphique de la montre ; le concepteur indique la quantité utilisée sur le modèle actuel.

Mode Always On

Sur les écrans AMOLED, en mode Always On, le cadran affiche uniquement les éléments marqués Afficher en mode Always On, sur fond noir et avec un léger décalage chaque minute pour protéger l'écran. Garmin autorise au maximum 10 % de pixels allumés dans ce mode ; le concepteur affiche cette valeur au-dessus de l'écran. Les secondes et la trotteuse ne sont pas affichées dans ce mode.

Compilation

  • Compiler pour cette montre (.prg) - fichier pour le modèle actuel à installer sur votre montre.
  • Compiler pour le Connect IQ Store (.iq) - paquet pour tous les modèles sélectionnés à publier dans le Connect IQ Store. Chaque compilation .iq reçoit un nouveau numéro de version.

Les compilations sont mises en file d'attente et prennent généralement environ une minute. L'onglet Compilations affiche l'état, le lien de téléchargement et le journal de compilation.

L'UUID de l'application dans l'onglet Cadran identifie l'application dans le store. Ne le modifiez pas entre les versions. Pour mettre à jour une application déjà publiée, saisissez son UUID.

Installer un fichier .prg sur la montre

Connectez la montre à l'ordinateur avec le câble USB et copiez le fichier .prg dans le dossier GARMIN/Apps de la montre. Après avoir débranché le câble, le cadran apparaît dans la liste des cadrans de la montre.

  • Windows : la montre apparaît dans l'Explorateur de fichiers comme un appareil (par exemple "fēnix 7"). Ouvrez Internal Storage → GARMIN → Apps et copiez-y le fichier.
  • macOS : la plupart des montres récentes se connectent via MTP, que macOS ne prend pas en charge sans logiciel supplémentaire. Installez OpenMTP (gratuit), connectez la montre, ouvrez GARMIN/Apps et copiez-y le fichier. Fermez Garmin Express auparavant, sinon il prend le contrôle de la connexion.
  • Linux : la montre apparaît dans le gestionnaire de fichiers (GNOME Files, Dolphin) comme un appareil MTP ; ouvrez GARMIN/Apps et copiez-y le fichier. Sans environnement graphique, la montre peut être montée avec jmtpfs ou simple-mtpfs.

Pour supprimer le cadran, supprimez le fichier de GARMIN/Apps ou supprimez-le sur la montre.

Remarque : les réglages d'un cadran installé de cette façon ne peuvent pas être modifiés dans l'application Garmin Connect, il utilise les réglages par défaut. Pour tester les réglages, publiez le cadran dans le store en tant qu'application bêta.

Publication dans le Connect IQ Store

Le concepteur ne téléverse pas de fichiers dans le store. Connectez-vous au tableau de bord développeur Connect IQ (apps.garmin.com/developer), créez une application de type "watch face", téléversez le fichier .iq, ajoutez une description et des captures d'écran et soumettez l'application à la vérification.

Pour mettre à jour l'application, compilez un nouveau fichier .iq (sa version augmente automatiquement) et téléversez-le comme nouvelle version de la même application. L'UUID et la clé de développeur doivent rester les mêmes.

API

Aperçu

L'API PayToUse exerce les fonctions suivantes :

  1. Vérifie le statut d'activation d'un code de déverrouillage et l'active si nécessaire.
  2. Récupère les données de glucose sanguin de l'application NightScout.
  3. Récupère les données météorologiques actuelles pour un emplacement spécifié.

Toutes les informations peuvent être demandées et retournées en une seule requête.

Points de terminaison de l'API

Vous pouvez utiliser l'un des points de terminaison suivants :

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

Les deux points de terminaison gèrent les requêtes GET et POST.

Paramètres de la requête

  • device: chaîne (requis) — identifiant unique de l'appareil
  • app: entier (requis) — l'identifiant de votre application
  • model: chaîne (facultatif) — code du modèle d'appareil, nécessaire pour collecter et afficher les statistiques des appareils utilisant l'application
  • code: chaîne (facultatif) — code de déverrouillage
  • bg: tableau associatif (facultatif) — données pour demander les niveaux de glucose sanguin de l'application NightScout
    • url: chaîne (facultatif) — adresse de l'application NightScout
  • weather: tableau associatif (facultatif) — données pour demander la météo actuelle
    • appid: chaîne (facultatif) — clé d'accès à l'API météo
    • lat: float (facultatif) — latitude
    • lon: float (facultatif) — longitude
    • provider: entier (facultatif) — fournisseur météo

Liste des fournisseurs de météo pris en charge

1. OpenWeatherMap

  • Description: OpenWeatherMap fournit des données météorologiques mondiales, y compris la météo en temps réel, les données historiques et les prévisions sur 16 jours. Avec une couverture géographique large et des mises à jour fréquentes, OpenWeatherMap est un choix populaire pour les applications nécessitant à la fois la météo actuelle et les prévisions étendues.
  • Données fournies: Température en temps réel, humidité, vitesse du vent, qualité de l'air, probabilité de précipitations et bien d'autres. Offre à la fois des données actuelles et des données de prévision, y compris les données météorologiques minute par minute pour les lieux sélectionnés.
  • Sélection du fournisseur: Incluez provider = 1 dans la section weather de votre requête pour sélectionner OpenWeatherMap comme fournisseur de météo.
  • Notes d'utilisation: Offre des niveaux gratuits et payants, avec des données accessibles via l'authentification par clé API. Les couches de données avancées et les fonctionnalités premium sont disponibles dans les plans payants.
  • One Call API 3.0: L’indice UV n’est disponible qu’avec une clé abonnée à One Call API 3.0 (un abonnement distinct dans votre compte OpenWeatherMap). Avec une telle clé, une seule requête One Call remplace les requêtes séparées de météo actuelle et de prévisions. Si One Call refuse la clé, l’API gratuite 2.5 est utilisée et One Call est réessayé au bout d’un jour.
  • Documentation de l'API: Disponible ici.

2. QWeather

  • Description: QWeather, également connu sous le nom de HeWeather, fournit des données météorologiques complètes axées sur la Chine mais incluant également des données internationales. Il offre des détails étendus tels que la météo en temps réel, les prévisions, les informations sur la qualité de l'air et les alertes.
  • Données fournies: Température actuelle, humidité, indice UV, niveaux de pollution, prévisions quotidiennes et horaires, ainsi que des avertissements pour les conditions météorologiques graves. Connu pour ses données granulaires sur la qualité de l'air et ses mises à jour en temps réel sur les conditions météorologiques changeantes.
  • Sélection du fournisseur: Incluez provider = 2 dans la section weather de votre requête pour sélectionner QWeather comme fournisseur de météo.
  • Notes d'utilisation: QWeather offre un accès API avec des niveaux gratuits et premium. Le niveau gratuit fournit des données limitées, tandis que les options premium s'étendent pour couvrir des points de données et des emplacements supplémentaires.
  • Documentation de l'API: Disponible ici.

3. MET Weather (MET Norway)

  • Description: L'API MET Weather, fournie par MET Norway, donne accès à une variété de données météorologiques ouvertes, y compris les prévisions, les données historiques et les données spécifiques pour la Norvège et les régions nordiques. Connu pour sa précision et sa transparence, MET Weather est idéal pour les applications ayant besoin de données météorologiques hautement fiables.
  • Données fournies: Conditions météorologiques actuelles, prévisions, précipitations, température, données du vent et indice UV. MET Weather offre des données spécialisées pour les régions nordiques mais prend également en charge les informations météorologiques mondiales.
  • Sélection du fournisseur: Incluez provider = 3 dans la section weather de votre requête pour sélectionner MET Weather comme fournisseur de météo.
  • Notes d'utilisation: Toutes les données fournies par MET Weather sont librement disponibles pour une utilisation sous licence Creative Commons, permettant les applications commerciales et non commerciales sans frais. MET Norway est réputée pour ses données environnementales, ce qui en fait un fournisseur de confiance, particulièrement en Europe.
  • Documentation de l'API: Disponible ici.

Exemple de requête

/source/background.mc
function onTemporalEvent() as Void {
	var ds = System.getDeviceSettings();
	if (!ds.phoneConnected) { // Vérifie que l'appareil est connecté au téléphone pour l'envoi de la requête
		return;
	}

	var id = ds.uniqueIdentifier;
	if (id == null) { // Vérifie que l'appareil a reçu un identifiant unique
		return;
	}

	var request = {};

	var lockCheck = Application.Storage.getValue("LastCodeCheckTimestamp");
	if (lockCheck == null || lockCheck <= Time.now().value()) { // Envoie le code si nécessaire
		request.put("code", Application.Properties.getValue("UnlockCode"));
	}

	var ns_url = Application.Properties.getValue("NS");
	if (!ns_url.equals("")) { // Envoie l'URL de l'application NightScout si nécessaire
		request.put("bg", { "url" => ns_url });
	}

	var wP = Application.Properties.getValue("Weather");
	if (wP != 0) { // Envoie les paramètres de requête de météo si nécessaire
		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()) {

		// Remplit les paramètres de requête requis
		request.put("device", id);
		request.put("app", p2uAppID); // l'identifiant de votre application
		request.put("model", ds.partNumber);

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

Réponse de l'API

L'API renvoie un objet JSON avec des informations sur l'état du déverrouillage, le niveau de glucose et la météo.

Paramètres de réponse

Résultats de la vérification du code de déverrouillage (si une requête a été envoyée):

  • response: entier — code de retour
  • msg: chaîne — message sur le résultat de la vérification
  • code: chaîne — le code de déverrouillage auquel se rapporte le résultat, s'il est connu
  • expires: entier — horodatage d'expiration du code au format UNIXTIMESTAMP
  • qr: array — Code QR pour la vérification du numéro de série ou de l'achat, le cas échéant

Réponse de l'application NightScout (si une requête a été envoyée):

  • bg: tableau associatif — réponse formatée de l'application NightScout
    • value: entier — niveau de glucose sanguin en mg/dL
    • date: entier — horodatage de l'expiration du code au format UNIXTIMESTAMP
    • direction: chaîne — tendance du changement du niveau de glucose sanguin

Réponse de l'API météo (si une requête a été envoyée):

  • weather: tableau associatif — réponse formatée de l'API météo
    • provider: entier — identifiant du fournisseur de météo
    • weather: array — conditions météorologiques actuelles. Peut renvoyer une ou deux valeurs ; si deux valeurs sont renvoyées, elles représentent les conditions de jour et de nuit
    • temp: float — température actuelle en degrés Celsius
    • feels_like: float — température ressentie en degrés Celsius
    • pressure: entier — pression atmosphérique en hPa
    • humidity: entier — humidité en %
    • precipitation: entier — probabilité de précipitation en %
      Pour MET Weather, uniquement dans les pays nordiques. -1 si la valeur n’est pas disponible.
    • wind: entier — direction du vent en degrés
    • wind_speed: float — vitesse du vent en m/s
    • wind_gust: float — vitesse des rafales de vent en m/s
      Non disponible pour QWeather. Pour MET Weather, uniquement dans les pays nordiques. -1 si la valeur n’est pas disponible.
    • uvi: float — indice UV
      Pour OpenWeatherMap, uniquement avec une clé abonnée à One Call API 3.0. Pour QWeather, le maximum journalier. Pour MET Weather, l’indice UV par ciel clair. -1 si la valeur n’est pas disponible.
    • temp_low: float — la température minimale d'aujourd'hui en degrés Celsius
    • temp_high: float — la température maximale d'aujourd'hui en degrés Celsius
    • sunrise_today: entier — l’horodatage du lever du soleil d'aujourd'hui au format UNIXTIMESTAMP
    • sunset_today: entier — l’heure du coucher du soleil d'aujourd'hui au format UNIXTIMESTAMP
    • sunrise_tomorrow: entier — l’horodatage du lever du soleil de demain au format UNIXTIMESTAMP
    • sunset_tomorrow: entier — l’heure du coucher de soleil de demain au format UNIXTIMESTAMP
    • aqi: tableau associatif — indice de qualité de l'air
      • level: entier — niveau d'indice de qualité de l'air
      • value: entier — valeur d'indice de qualité de l'air

Exemple de réponse

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

Codes de réponse

Le champ response du résultat de la vérification du code de déverrouillage prend l'une des valeurs suivantes. Des exemples de réponses et l'ordre des vérifications sont décrits dans Vérifications côté API.

Code Description
101Le code est valide. L'application peut être déverrouillée.
102Aucun code valide, mais la période d'essai n'est pas encore terminée. L'application peut être déverrouillée jusqu'à la date du champ expires.
103Aucun code valide, mais l'appareil est un bêta-testeur : son premier appel à l'API a eu lieu avant la date du champ Date de sortie de l'application. L'application peut être déverrouillée jusqu'à la date du champ expires (0 - sans limite).
201Le code est introuvable ou a été supprimé.
202Le code est déjà activé sur un autre appareil.
203Le code a expiré.
204La période d'essai est terminée et aucun code valide n'a été envoyé.
301L'application est introuvable ou n'est pas disponible.
302La durée du code n'est pas définie.
303Paramètres insuffisants dans la requête.
304L'identifiant de l'appareil est requis pour cette application.
401Erreur lors de l'enregistrement du code. Écrivez au support à [email protected].
402Erreur lors de l'enregistrement de l'appareil. Écrivez au support à [email protected].
500Erreur inconnue. Écrivez au support à [email protected].

Les codes 1xx signifient que l'application peut être déverrouillée, 2xx - qu'elle doit rester verrouillée, 3xx - une erreur dans la requête, 4xx et 5xx - une erreur côté PayToUse. En cas d'erreurs 4xx et 5xx, il est recommandé de conserver le dernier résultat réussi et de répéter la requête plus tard.

Si l'option Autoriser le renvoi du code par identifiant d'appareil est activée dans les paramètres de l'application, que la requête contient un identifiant d'appareil mais pas de code, et qu'un code valide est déjà lié à cet appareil, l'API renvoie 101 avec ce code dans le champ code. L'application peut l'enregistrer et ne plus demander à l'utilisateur de le saisir.

Notes

  • Les requêtes avec bg nécessitent une connexion à l'application NightScout.
  • Pour chaque requête avec code, l'API vérifie automatiquement l'état du code et l'active s'il est inactif.
  • Veuillez noter que les paramètres de l'API peuvent être mis à jour ou modifiés au fil du temps pour améliorer la fonctionnalité, la compatibilité et la sécurité. Il est recommandé de revoir régulièrement la documentation de l'API pour toute modification qui pourrait affecter l'intégration ou l'utilisation.

Fournisseurs météo

Ci-dessous, la correspondance entre les conditions météo renvoyées dans le champ weather et les valeurs de chaque fournisseur.

Garmin

Pour une description détaillée des fonctions et constantes de météo du SDK Garmin, veuillez consulter ce lien. Vous pouvez stocker les valeurs obtenues à partir de l'API ou les résultats des fonctions de météo du SDK Garmin, en fonction du fournisseur de météo sélectionné, pour assurer la cohérence de l'affichage des valeurs sur l'écran.

ID Description Jour Nuit
0 Ciel dégagé
0x53

0x54
40 Beau temps
23 Plutôt dégagé
0x55

0x56
1 Partiellement nuageux
0x57

0x58
22 Partiellement dégagé
2 Très nuageux
0x59
52 Voile nuageux
20 Nuageux
0x5A
45 Ciel nuageux avec des risques de pluie
31 Bruine
0x3E
14 Pluie faible
0x42
24 Légères averses
3 Pluie
0x43
25 Averses
27 Risque d'averses
0x46
11 Averses éparses
15 Forte pluie
26 Fortes averses
28 Risque d'orages
0x36

0x37
12 Orages épars
0x38
6 Orages
0x39
8 Brouillard
0x4E
9 Brumeux
29 Brume
39 Brume sèche
30 Poussière
0x4F
35 Sable
33 Fumée
38 Cendre volcanique
37 Tempête de sable
13 Précipitations
5 Venteux
0x52
36 Bourrasque
48 Averses de neige
32 Tornade
0x50
41 Ouragan
42 Tempête tropicale
50 Neige fondue
0x45
7 Mélange hivernal
18 Faible pluie et neige
19 Fortes pluies et chutes de neige
21 Pluie et neige
49 Pluie verglaçante
44 Risque de pluie ou de neige
47 Temps nuageux, risque de pluie ou de neige
34 Glace
51 Glace et neige
43 Risque de neige
0x4C

0x4D
16 Neige légère
46 Ciel nuageux avec des risques de neige
0x4A
4 Neige
17 Fortes chutes de neige
0x4B
10 Grêle
0x3A

Open Weather Map

Consultez, à titre d'exemple, le jeu d'icônes d'OpenWeatherMap ici.

ID Description Jour Nuit
2xx Orage
200 Orage avec pluie légère
0x36

0x37
201 Orage avec pluie
0x38
202 Orage avec de fortes pluies
210 Orage léger
211 Orage
0x39
212 Violent orage
0x3B
221 Orage irrégulier
230 Orage avec bruine légère
0x3A
231 Orage avec bruine
232 Orage avec forte bruine
3xx Bruine
300 Bruine légère
0x3C

0x3D
301 Bruine
0x3E
302 Forte bruine
0x3F
310 Bruine légère et pluie
0x40
311 Bruine et pluie
312 Forte bruine et pluie
0x41
313 Averses et bruine
314 Forte averse et bruine
321 Averses de bruine
5xx Pluie
500 Pluie faible
0x42
501 Pluie modérée
0x43
502 Forte pluie
0x44
503 Pluie très forte
504 Pluie extrême
511 Pluie verglaçante
0x45
520 Légères averses
0x46
521 Averses
522 Fortes averses
531 Averses irrégulières
6xx Neige
600 Neige légère
0x4C

0x4D
601 Neige
0x4A
602 Fortes chutes de neige
611 Neige fondue
0x45
612 Légères averses de neige fondue
613 Averses de neige fondue
615 Pluie et neige légères
616 Pluie et neige
620 Légère averse de neige
0x4B
621 Averses de neige
622 Fortes averses de neige
7xx Atmosphère
701 Brume
0x4E
711 Fumée
0x4F
721 Brume sèche
731 Tourbillons de sable et de poussière
741 Brouillard
751 Sable
0x4F
761 Poussière
762 Cendre volcanique
771 Grains
0x52
781 Tornade
0x50
800 Ciel dégagé
800 Ciel dégagé
0x53

0x54
80x Nuages
801 Peu nuageux 11–25 %
0x55

0x56
802 Nuages épars 25–50 %
0x57

0x58
803 Nuageux 51–84 %
0x59
804 Couvert 85–100 %
0x5A

QWeather

Vous pouvez consulter la série originale d'icônes météo en cliquant ici

ID Description Jour Nuit
302 Averse orageuse
0x36

0x37
303 Violent orage
0x38
310 Pluie diluvienne
0x39
317 Pluie diluvienne à forte pluie diluvienne
304 Grêle
0x3A
311 Forte pluie diluvienne
0x3B
312 Très forte pluie diluvienne
318 Pluie diluvienne forte à très forte
309 Bruine
0x3C

0x3D
404 Neige fondue
0x3E
305 Pluie légère
0x42
314 Pluie légère à modérée
306 Pluie modérée
0x43
315 Pluie modérée à forte
399 Pluie
308 Pluie extrême
0x44
316 Forte pluie à pluie diluvienne
313 Pluie verglaçante
0x45
405 Pluie et neige
300 Averses
0x46
301 Fortes averses
307 Fortes pluies
350 Averses
351 Fortes averses
400 Neige légère
0x4C

0x4D
408 Chutes de neige faibles à modérées
499 Neige
401 Chutes de neige modérées
0x4A
402 Fortes chutes de neige
409 Chutes de neige modérées à abondantes
410 Fortes chutes de neige, voire tempête de neige
403 Tempête de neige
0x4B
406 Averses de pluie et de neige
407 Averses de neige
456 Averses de pluie et de neige
457 Averses de neige
503 Sable
0x4E
504 Poussière
507 Tempête de poussière
508 Tempête de sable
511 Brume sèche modérée
512 Brume sèche dense
513 Brume sèche très dense
500 Brume
0x4F
501 Brouillard
502 Brume sèche
509 Brouillard dense
510 Brouillard épais
514 Brouillard très épais
515 Brouillard extrêmement épais
100 Ensoleillé
0x53

0x54
150 Ciel dégagé
101 Nuageux
0x55

0x56
151 Nuageux
102 Quelques nuages
0x57

0x58
152 Quelques nuages
103 Partiellement nuageux
0x59
153 Partiellement nuageux
104 Couvert
0x5A

MET Weather

Consultez, à titre d'exemple, le jeu d'icônes de MET Weather ici.

ID Description Jour Nuit
lightrainshowers Légères averses
0x36

0x37
lightrainshowersandthunder Légères averses et orages
rainshowersandthunder Averses et orages
heavyrainshowersandthunder Fortes averses et orages
heavyrainandthunder Fortes pluies et orages
0x38
rainandthunder Pluie et orages
lightrainandthunder Pluie légère et orages
0x39
heavysleetandthunder Forte neige fondue et orages
0x3B
lightsleetandthunder Légère neige fondue et orages
0x3A
lightssleetshowersandthunder Légères averses de neige fondue et orages
sleetandthunder Neige fondue et orages
lightsleetshowers Légères averses de neige fondue
0x3C

0x3D
sleetshowers Averses de neige fondue
sleetshowersandthunder Averses de neige fondue et orages
heavysleetshowers Fortes averses de neige fondue
heavysleetshowersandthunder Fortes averses de neige fondue et orages
lightsleet Légère neige fondue
0x3E
sleet Neige fondue
0x3F
heavysleet Forte neige fondue
0x45
lightrain Pluie faible
0x42
rain Pluie
0x43
heavyrain Forte pluie
0x44
rainshowers Averses
0x46
heavyrainshowers Fortes averses
heavysnow Fortes chutes de neige
0x4B
heavysnowandthunder Fortes chutes de neige et orages
snow Neige
snowandthunder Neige et orages
lightsnowshowers Légères averses de neige
0x4C

0x4D
lightssnowshowersandthunder Légères averses de neige et orages
snowshowers Averses de neige
snowshowersandthunder Averses de neige et orages
heavysnowshowers Fortes averses de neige
heavysnowshowersandthunder Fortes averses de neige et orages
lightsnow Neige légère
0x4A
lightsnowandthunder Légères chutes de neige et orages
fog Brouillard
0x4F
clearsky Ciel dégagé
0x53

0x54
fair Beau temps
0x55

0x56
partlycloudy Partiellement nuageux
0x57

0x58
cloudy Nuageux
0x59