:署名

1. ソートパラメーター

   すべてのリクエストパラメーター (共通リクエストパラメーターと、このドキュメントで解説する任意のリクエストインターフェイスでのユーザー定義パラメーターは含まれますが、"共通リクエストパラメーター" で言及されている Signature パラメーターは含まれません) をパラメーター名でアルファベット順に並べ替えます。

   重要 GET メソッドを使用してリクエストをサブミットする場合、これらのパラメーターは、URI のアンパサンド (&) に続く疑問符 (?) の後の部分であるリクエスト URI に含まれています。
2. エンコードパラメーター
   各リクエストパラメーターの名前と値をエンコードします。 名前と値は、UTF-8 文字セットを使用した URL エンコードする必要があります。 URL のエンコード規則は以下のとおりです。

   • 大文字 (A - Z)、小文字 (a - z)、数字 (0 - 9)、およびハイフン (-)、アンダースコア (_)、ピリオド (.)、波形符号 (~) はエンコードされません。

   • 他の文字は “%XY” 形式でエンコードします。XY は、ASCII 文字コードの 16 進表記を表します。 たとえば、二重引用符 (“) は “%22” でコーディングします。

   • 拡張 UTF-8 文字は “％XY％ZA… “ でエンコードされます。

   • 英語のスペースはプラス記号 (+) ではなく ％20 でエンコードすることにご注意ください。

   重要 このエンコード方式は、application/x-www-form-urlencoded MIME エンコードアルゴリズム (Java 標準ライブラリーで提供される java.net.URLEncoder クラスの実装など) と類似していますが、異なる方式です。 エンコードした文字列内のプラス記号 (+) を "%20"、アスタリスク (*) を "%2A" に直接置き換え、"%7E" を波形符号 (~) に戻せば、上記のエンコード規則に準拠してこのエンコード方式を使用することができます。 このアルゴリズムは、以下の percentEncode() メソッドを使用して実装できます。

   private static final String ENCODING = "UTF-8";
   private static String percentEncode(String value) throws UnsupportedEncodingException {
     return value ! = null？ URLEncoder.encode(value, ENCODING).replace("+", "%20").replace("*", "%2A").replace("%7E", "~") : null;
   }

3. エンコードされたパラメーター名と値を等号 (=) で接続します。
4. 次に、アルファベット順に等号で接続されたパラメーター名と値のペアをソートし、アンパサンド (&) で接続して正規化クエリ文字列を生成します。

StringToSign=
  HTTPMethod + “&” +
  percentEncode(“/”) + ”&” +
   percentEncode(CanonicalizedQueryString)

この公式では、HTTPMethod はリクエストのサブミットに使用される HTTP メソッド (GET など) です。 percentEncode (“ /“) は、1.ii で説明した URL エンコーディング規則に従って、文字 “ /” のエンコード値 (％2F) です。 percentEncode (CanonicalizedQueryString) は、1.ii で説明した URL エンコード規則に従ってステップ 1 で構成された正規化クエリ文字列のエンコードされた文字列です。