Services et API

Avatar pour les programmeurs et les développeurs dans l'environnement Web via l'interface de programmation permet l'utilisation du logiciel d'avatar dans le cadre de leur programme. Si vous êtes un développeur de jeux ou de logiciels, vous pouvez facilement créer votre avatar préféré et l'afficher dans votre logiciel ou jeu en utilisant quelques lignes de code.

Comment

Confiez-nous la production et
la présentation des avatars

Après l'enregistrement et la réception de l'abonnement au service avatarz.top, vous pouvez enregistrer votre site Web ou votre logiciel via le tableau de bord du site. Après avoir enregistré chaque logiciel, un code Token unique est généré pour le site enregistré et il vous est fourni que vous devez utiliser ce Token pour accéder au créateur d'avatars.

Figure 1 - Tableau de bord APItra
Figure 1 - Tableau de bord API
Figure 2 - Ajouter un site
Figure 2 - Ajouter un site
Figure 3 - Obtenir un jeton
Figure 3 - Obtenir un jeton

Les modalités de communication de votre logiciel ou jeu et avatar sont les suivantes:

  • Avatar maker appels par vos utilisateurs depuis votre logiciel: Pour ajouter la possibilité d'enregistrer un dessin animé ou une image d'avatar aux utilisateurs, le développeur doit diriger les utilisateurs vers la page du créateur d'avatars via un lien spécifique.

Exemple d'adresse de lien:

https://www.avatarz.top/generator?rt=[avatarMeToken]&ut=[playerToken]&avatar=[avatarCode]&theme=[themeCode]
    

avatarMeToken: Dans cette partie de l'adresse, vous devez entrer le jeton que vous avez reçu de ce site conformément à la figure 3.

playerToken: Chaque utilisateur de votre application doit avoir son propre identifiant ou jeton unique. Pour que l'utilisateur revienne au logiciel après que l'utilisateur soit revenu à votre logiciel, vous pouvez être sûr que la coordination du travail est retournée et que l'utilisateur de votre site est sûr, quelle que soit la valeur que vous nous envoyez, l'avatar enverra lorsque le l'utilisateur revient sur votre site.

avatarCode: Il s'agit de la quantité de code d'avatar utilisateur stockée sur votre site. Laissez cette valeur vide si vous n'avez pas encore enregistré de code pour votre avatar d'utilisateur.

themeCode: Si vous souhaitez que le créateur de l'avatar ressemble davantage à votre logiciel ou à votre jeu, vous pouvez choisir le thème de l'avatar à afficher pour vos utilisateurs. Si votre logiciel utilise des thèmes différents tels que le mode jour et nuit, vous pouvez diriger les utilisateurs vers le créateur d'avatars en fonction du thème sélectionné dans votre logiciel ou jeu. Vider cette valeur affichera le créateur d'avatar avec le thème par défaut.
Valeurs de divers thèmes: dark, light

Exemple de lien en HTML:

<a href="https://www.avatarz.top/generator?rt=[avatarMeToken]&ut=[playerToken]&avatar=[avatarCode]">
Modifier Avatar
</a>
    
Notez qu'il n'est pas nécessaire d'ouvrir l'avatar dans un nouvel onglet du navigateur, l'utilisateur sera renvoyé à l'adresse de retour après avoir rempli les modifications, que vous remplissez dans le formulaire de la figure 2.
Exemple de lien en JavaScript:

window.location = 'https://www.avatarz.top/generator?rt=[avatarMeToken]&ut=[playerToken]&avatar=[avatarCode]';
    

  • Retour utilisateur d'Avatar vers votre logiciel: Après avoir apporté des modifications à son avatar, l'utilisateur reviendra à l'adresse de retour enregistrée dans le tableau de bord comme illustré à la figure 2 en appuyant sur le bouton Enregistrer.
    Le créateur d'avatar renvoie les valeurs du code d'avatar sélectionné par l'utilisateur sur votre site sous forme de QueryString avec l'adresse de retour enregistrée.

Exemple:

Par exemple, votre site ou votre jeu se trouve à http://sample.com/.
L'adresse de retour que vous avez saisie dans le tableau de bord de votre site est http://sample.com/save_avatar/.
L'adresse que vous redirigez vers le créateur d'avatar est https://www.avatarz.top/generator?rt=XXXX&ut=player01.
L'URL que l'utilisateur renvoie vers votre site à partir du créateur d'avatar sera http://sample.com/save_avatar/?ut=player01&avatar=00010100030502.

Vous devez identifier l'utilisateur sur la page de retour si vous êtes connecté. Pour des raisons de sécurité, vous devez faire correspondre votre soumission playerToken retournée par l'autorépondeur à l'utilisateur que vous avez identifié sur le site, et si confirmé, le code unique de cet utilisateur. Enregistrez la valeur de l'avatar envoyée dans QueryString à l'utilisateur dans la base de données.

Notez que n'a besoin que d'enregistrer ce code pour l'utilisateur dans son logiciel et Avatar ne stocke aucune donnée de votre utilisateur telle que playerToken ou même le code d'avatar et vous êtes responsable de l'enregistrement de ce montant.

Le nombre de fois où les utilisateurs utilisent Avatar pour créer l'image qu'ils souhaitent et le nombre d'images qu'ils créent sont gratuits et ne sont pas enregistrés dans vos demandes de site.

  • Afficher les avatars des utilisateurs dans votre application: Pour afficher un avatar créé par l'utilisateur sur votre site Web ou votre jeu, vous devez saisir l'adresse de l'image selon le modèle suivant ainsi que le code de l'avatar de l'utilisateur que vous avez enregistré sur votre site:

Exemple:

https://www.avatarz.top/avatars/[avatarCode]
    

avatarCode: Le code stocké sur votre site pendant le processus de retour de l'utilisateur d'Avatar vers votre site ou logiciel.

Exemple d'affichage en HTML:

<img src="https://www.avatarz.top/avatars/[avatarCode]">
    

Ces demandes seront validées par l'URL de référence de la demande. Mais vous pouvez également valider votre requête, en ajoutant votre jeton de validation dans l'en-tête de la requête :


token: [YOUR_VALIDATION_TOKEN]
    

Le nombre de requêtes calculé par votre site correspond au nombre de requêtes pour afficher l'image d'avatar des utilisateurs sur votre site Web. En utilisant ce système, le volume de charge et la consommation d'espace de bande passante et de disque par les images d'avatar des utilisateurs seront à la charge de nos serveurs.

Rapport quotidien sur les performances de l'API

Vous pouvez voir le nombre de demandes pour chacun de vos projets de jeux ou de logiciels sur la page de rapport dans le tableau de bord de ce site.

Figure 4 - Page de rapport
Figure 4 - Page de rapport

Si vous n'avez pas encore d'abonnement, vous pouvez commencer à recevoir des abonnements aux services avatarz.top et à partir d'aujourd'hui, vous pouvez utiliser votre jeu et votre logiciel pour afficher des avatars pour l'image de l'utilisateur. Si vous avez encore besoin de plus de preuves pour décider et utiliser notre créateur d'avatars dans votre logiciel, contactez-nous et demandez une démo.