前提条件: クエリ結果のコールバック URL ウェブフック用
Amzpecty には、Webhook データ プッシュ API 通知用のコールバック URL が必要です。 これらにより、アプリにクエリ結果 (データ ペイロードを含む) が通知されます。 コールバック URL は、https POST プロトコルを使用し、有効な SSL 証明書を使用してグローバルにアクセスできる必要があります。 Amzpecty は自己署名 SSL 証明書に Webhook を正常に送信できない場合があります。
Java では、doPost メソッドで HttpServlet を使用して、Amzpecty データ ペイロードを受信できます。 他のプログラミング言語でも、同じ同等のソリューションを実装できます。 Webhook リスナーは、HTTPS Post プロトコルをサポートする任意のプログラミング言語を使用して実装できます。
コールバック URL が準備ができており、 Amzpecty ダッシュボード https://api.amzpecty.com/preferences。 Amzpecty がデータの検索を完了すると、Amzpecty は JSON 形式の結果データをこの URL に HTTPS Post します。 AMZPECTY_CALLBACK_URL ヘッダーがリクエスト呼び出しに追加されると、設定コールバック URL 設定よりも優先されます。
AMZPECTY-API-SECRET-KEY という名前の http ヘッダーは、Webhook リスナーがリクエストの発信元を検証するために https ポストに含まれます。
手順と手順
- 追加通話を行う [ Asin/ISBN を Asin スナップショット クエリ キューに追加 ] または [製品バリエーション クエリ キューに親 Asin を追加] または [ 製品IDをASINクエリキューに一致させる ] などを使用して、リクエストをクエリキューに入れます。
- Amzpecty API サーバーは、検索が完了するとすぐにコールバック URL を呼び出して結果を送信します。
- アプリケーションは、コールバックを元のリクエストに一致させるために、通話応答の追加からの削除を使用することができます。
Note: 非バリアント関連のコールの場合、ASIN が親 ASIN または廃止された ASIN でないことを確認してください。
かなりの時間が経過し、コールバックが受信されない限り、オプションの Get クエリを作成する必要はありません。 同じ ASIN の連続した Add 呼び出しは行わないでください。
ユーザーエージェントのオーバーライド
クライアントは、Add 呼び出し中に AMZPECTY-USER-AGENT キーと値を指定することで、特定のヘッダーのデフォルトの User-Agent ヘッダーをオーバーライドできます。
Amzpecty API は、ポストバック呼び出し中に User-Agent 値を設定します。
エンコーディング
- リクエスト/レスポンスデータのエンコードはUTF-8である必要があります。
終点
専用サーバーまたはカスタム サーバーのカスタム URL については、サポートにお問い合わせください。
SECURITY
- Amzpecty とピア間のすべてのデータ交換接続は、有効な SSL 証明書を使用した HTTPS (SSL/TLS) 経由である必要があります。
- Amzpecty は、リクエスト認証用の秘密キーを発行します (パラメーター名は SecretKey) – 秘密キーは、[設定ページ] > [Amzpect API] > [API 秘密キー] で見つかります。
クエリの応答時間
すべてのクエリリクエストをタイムリーに処理するよう最善を尽くしていますが、 結果のコールバックの適時性は保証しません。 実装する際は応答の遅延を考慮してください。
リクエストスロットル
API 呼び出しが拒否されないように、リクエストが少なくとも 1 ～ 2 秒の間隔に設定されていることを確認してください。 過剰なバーストリクエストを回避するためのチェックが行われています。 カスタム サーバーの例外についてはサポートにお問い合わせください。
クレジット控除
クレジットは、データの取得が成功した場合にのみ差し引かれます。 Get by RID などの Get 呼び出しでは、クレジットは差し引かれません。
