ユーザーの注文状況を取得

ユーザーの注文状況を取得

ユーザーの注文状況を取得するには、以下の方法を使用します：

1. サーバー側でウェブフックを利用する。
2. クライアント側でWebSocket APIまたはIGS APIを使用する。

ウェブフックを利用してサーバーサイドでユーザーの注文状況を取得する

WebSocket APIまたはIGS APIを経由して、クライアント側でユーザーの注文状況を取得する

1. WebSocket API。
2. Short-polling。

WebSocket APIを使用してクライアント側で注文状況の取得

このソリューションでは、websocketを使用して、注文の詳細情報を取得せずに注文状況を取得します。このメソッドが推奨されます：クライアント（例えば、ウェブサイトやモバイルアプリケーション）とエクソーラサーバー間には1つの接続しか作成されないため、クライアントやサーバーへの追加の負荷は発生しません。

以下の手順を完了してください：

1. エクソーラのwebsocketサーバーとクライアントが注文状況メッセージを識別できるようにするために、接続を作成します：

const client = new Centrifuge(
connectionURL,
{
data: {
  user_external_id: user_external_id,
  auth: auth,
  project_id: project_id
}
}
)
connectionURL - wss://ws-store.xsolla.com/connection/websocket
auth - user JWT token

2. 注文状況に関する新しいメッセージを受信するには、client.on関数を使用してイベントを登録します：

client.on('publication', (ctx) => {
   //handle the status
});

3. 実際の接続確立をトリガーします：

client.connect()

4. 注文状況の変更履歴を受信するには、API履歴メソッドに接続してください。

client.on('subscribed', function (ctx) {
   client.history(ctx.channel, { limit: -1, since: { offset: 0 }, reverse: false }).then(function (resp) {
resp.publications.forEach((ctx) => {
   /handle the status
});

   }, function (err) {
       //handle the status
   });
});

メッセージ本文の例：

{
order_id: 59614241,
status: 'new'
}

以下の注文状況があります：

• New — オーダーは作成されたが未払いである
• Paid — 注文は支払われる
• Done — 注文が配信されたこと（すべての領収書の送付、エクソーラ側での配信、外部プラットフォームでの配信、など）
• Canceled — 注文がキャンセルされ、代金がユーザーに返金される

ウェブソケット経由の応答に必要な時間は5分です。その後、またはウェブソケットに問題がある場合は、ショートポーリングを使用することが推奨されます。

ショートポーリング

ステータスを切り替えた後のオーダーのアイテムの詳細情報を取得するには、注文を取得するAPIを呼び出します。