URL 特殊文字のエンコード
SCAPI では、コンマ ( , ) は値の区切り文字として使用され、パーセント記号 (%) は URL エンコードに使用されます。
これらの文字は予約文字として扱われ、SCAPI リクエストの以下のリソース識別子内で使用する場合は、さらに UTF-8 で URL エンコードする必要があります。
- リクエストパスパラメーター
- クエリパラメーター
たとえば、productID
、categoryID
、promotionID
などです。
リクエストパスパラメーター値のリソース識別子内にコンマ ( , ) またはパーセント記号 (%) が含まれている場合は、その値をさらに UTF-8 で URL エンコードする必要があります。次の例は、productId
リソース識別子のリクエストを示しています ("Flour,1KG")。
クライアントがリクエストを送信すると、通常、リクエストは HTTP ライブラリによってもう一度自動的にエンコードされ、SCAPI に送信されます。
SCAPI は、リクエスト内のリソース識別子をデコードします。
クエリパラメーター値のリソース識別子内にコンマ ( , ) またはパーセント記号 (%) が含まれている場合は、その値をさらに UTF-8 で URL エンコードする必要があります。次の例は、productId
リソース識別子のリクエストを示しています ("Flour,1KG") と ("1%Milk")。
クライアントがリクエストを送信すると、通常、リクエストは HTTP ライブラリによってもう一度自動的にエンコードされ、SCAPI に送信されます。
SCAPI は、リクエスト内のリソース識別子をデコードします。
通常、リソース識別子内では、コンマ ( , ) やパーセント記号 (%) などの特殊文字を使用しないことをお勧めします。