サービスとAPI

プログラミングインターフェイスを介したWeb環境のプログラマーおよび開発者向けのアバターでは、プログラムの一部としてアバターソフトウェアを使用できます。ゲームまたはソフトウェアの開発者であれば、数行のコードを使用して、お気に入りのアバターを簡単に作成し、ソフトウェアまたはゲームに表示できます。

方法

アバターの制作とプレゼンテーションは私たちにお任せください

登録して avatarz.topサービスサブスクリプションを受け取った後、サイトダッシュボードからWebサイトまたはソフトウェアを登録できます。各ソフトウェアを登録すると、登録されたサイトに対して一意のトークンコードが生成され、アバターメーカーにアクセスするにはこのトークンを使用する必要があることが提供されます。

図1-APIダッシュボード

図2-サイトの追加

図3-トークンの取得

ソフトウェアまたはゲームとアバターを通信する方法は次のとおりです。

アバターメーカーは、ユーザーがソフトウェアから呼び出します。 漫画やアバターの画像をユーザーに記録する可能性を追加するには、開発者は特定のリンクを介してユーザーをアバターメーカーのページに誘導する必要があります。

サンプルリンクアドレス：


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

avatarMeToken: アドレスのこの部分には、図3に従って、このサイトから受け取ったトークンを入力する必要があります。

playerToken: アプリケーションの各ユーザーは、独自のIDまたはトークンを持っている必要があります。ユーザーがソフトウェアに戻った後にユーザーがソフトウェアに戻るために、作業の調整が返され、サイトのユーザーが、どのような値を送信しても、アバターが次の場合に送信することを確認できます。ユーザーがサイトに戻ります。

avatarCode: これは、サイトに保存されているユーザーアバターコードの量です。ユーザーアバターのコードをまだ保存していない場合は、この値を空白のままにします。

themeCode: アバターの作成者をソフトウェアやゲームのように見せたい場合は、ユーザーに表示するアバターのテーマを選択できます。ソフトウェアでデイモードとナイトモードなどの異なるテーマを使用している場合は、ソフトウェアまたはゲームで選択したテーマに応じて、ユーザーをアバターメーカーに誘導できます。この値を空にすると、デフォルトのテーマでアバターメーカーが表示されます。
さまざまなテーマの価値: dark, light

HTMLのリンクサンプル:


<a href="https://www.avatarz.top/generator?rt=[avatarMeToken]&ut=[playerToken]&avatar=[avatarCode]">
アバターを編集する
</a>

ブラウザの新しいタブでアバターを開く必要はないことに注意してください。ユーザーは、図2のフォームに入力した変更を入力した後、差出人住所に戻ります。

JavaScriptのサンプルリンク:


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

ユーザーがアバターからソフトウェアに戻る： アバターに変更を加えた後、ユーザーは保存ボタンを押すと、図2に示すようにダッシュボードに登録されている差出人住所に戻ります。
アバターメーカーは、ユーザーが選択したアバターコードの値を、登録された差出人住所とともにQueryStringとしてサイトに返します。

例:

たとえば、サイトまたはゲームは次の場所にあります http://sample.com/.
サイトのダッシュボードに入力した差出人住所は http://sample.com/save_avatar/.
アバターメーカーにリダイレクトするアドレスは https://www.avatarz.top/generator?rt=XXXX&ut=player01.
ユーザーがアバターメーカーからサイトに返すURLは次のようになります http://sample.com/save_avatar/?ut=player01&avatar=00010100030502.

ログインしている場合は、リターンページでユーザーを特定する必要があります。セキュリティのために、オートレスポンダーから返されたplayerToken送信を、サイトで特定したユーザーと照合し、確認された場合は、このユーザーの一意のコードを照合する必要があります。 QueryStringで送信されたアバター値をデータベースのユーザーに保存します。

はユーザーのこのコードをソフトウェアに保存するだけでよく、アバターはplayerTokenやアバターコードなどのユーザーからのデータを保存せず、この量を保存するのはユーザーの責任であることに注意してください。

ユーザーがアバターを使用して必要な画像を作成する回数と作成する画像の数は無料であり、サイトのリクエストには記録されません。

アプリケーションにユーザーアバターを表示する: ユーザーが作成したアバターをWebサイトまたはゲームに表示するには、サイトに保存したユーザーアバターコードとともに、次のテンプレートに従って画像アドレスを入力する必要があります。

例:


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

avatarCode: ユーザーをアバターからサイトまたはソフトウェアに戻すプロセス中にサイトに保存されたコード。

HTMLでのサンプル表示:


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

これらのリクエストは、リクエストの参照URLによって検証されます。ただし、リクエストヘッダーに検証トークンを追加することで、リクエストを検証することもできます。


token: [あなたの検証トークン]

あなたのサイトによって計算されたリクエストの数は、あなたのウェブサイトにユーザーのアバター画像を表示するためのリクエストの数です。このシステムを使用すると、ユーザーのアバター画像による帯域幅とディスクの負荷とスペースの消費量がサーバーの責任になります。

毎日のAPIパフォーマンスレポート

このサイトのダッシュボードのレポートページで、各ゲームまたはソフトウェアプロジェクトのリクエスト数を確認できます。

図4-レポートページ

まだサブスクリプションをお持ちでない場合は、 avatarz.topサービスのサブスクリプションの受け取りを開始できます。本日から、ゲームとソフトウェアを使用して、ユーザー画像のアバターを表示できます。ソフトウェアでアバターメーカーを決定して使用するための証拠がさらに必要な場合は、お問い合わせしてデモをリクエストしてください。