URL 特殊文字のエンコード

SCAPI では、コンマ ( , ) は値の区切り文字として使用され、パーセント記号 (%) は URL エンコードに使用されます。

これらの文字は予約文字として扱われ、SCAPI リクエストの以下のリソース識別子内で使用する場合は、さらに UTF-8 で URL エンコードする必要があります。

  • リクエストパスパラメーター
  • クエリパラメーター

たとえば、productIDcategoryIDpromotionID などです。

リクエストパスパラメーター値のリソース識別子内にコンマ ( , ) またはパーセント記号 (%) が含まれている場合は、その値をさらに UTF-8 で URL エンコードする必要があります。次の例は、productId リソース識別子のリクエストを示しています ("Flour,1KG")。

クライアントがリクエストを送信すると、通常、リクエストは HTTP ライブラリによってもう一度自動的にエンコードされ、SCAPI に送信されます。

SCAPI は、リクエスト内のリソース識別子をデコードします。

クエリパラメーター値のリソース識別子内にコンマ ( , ) またはパーセント記号 (%) が含まれている場合は、その値をさらに UTF-8 で URL エンコードする必要があります。次の例は、productId リソース識別子のリクエストを示しています ("Flour,1KG") と ("1%Milk")。

クライアントがリクエストを送信すると、通常、リクエストは HTTP ライブラリによってもう一度自動的にエンコードされ、SCAPI に送信されます。

SCAPI は、リクエスト内のリソース識別子をデコードします。

通常、リソース識別子内では、コンマ ( , ) やパーセント記号 (%) などの特殊文字を使用しないことをお勧めします。