Encode Component
この関数は、文字列のすべての特殊文字を、URLで使用できるようにエンコードされたテキスト文字列にエンコードします。
この関数は、Decode Component関数の逆の動作を行います。
以前のステップで得られた値を返すURLを構築する場合は、この関数を使用してその値をエンコードできます。
エンコードする入力が複数ある場合は、Encode Query関数カードを使用してください。この関数は、オブジェクトを使用して単一のエンコードされたクエリ文字列を構築します。
入力
| フィールド | 定義 | タイプ | Required (必須) |
|---|---|---|---|
|
テキスト（text） |
エンコードするテキスト文字列。 |
テキスト | 正 |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
出力（output） |
エンコードされたテキスト。 |
テキスト |
区切り記号と特殊文字
APIリクエストを実行する際には、サーバーが特殊文字を正確に解釈するようにそれらの文字をエンコードすることが不可欠です。ただし、URLで使用される区切り記号はエンコードしないでください。
特殊文字には、スペース、句読点、非ASCII文字が含まれます。これらの文字を適切にエンコードしないと、URLに問題が生じる可能性があります。
区切り記号はURL構造の不可欠な部分であるため、エンコードしないでください。クエリ文字列の?区切り記号はURL内のリテラル文字です。この区切り記号を使用することで、Webサーバーはパスの終了位置とクエリ文字列の開始位置を認識できます。
特殊文字と区切り記号を参照してください。
例
入力がSherlock Holmes: Detectiveなら、エンコードされた出力はSherlock%20Holmes%3A%20Detectiveです。
次に、Format関数を使用して完全なURLを構築できます。エンコードされた出力をhttps://www.example.com/searchcustomers?name=に追加すると、https://www.example.com/searchcustomers?name=Sherlock%20Holmes%3A%20Detectiveという完全なURLが得られます。
