Skip to main content

Use URL encoding

Enables or disables standard encoding of special characters in URLs

Function UseURLEncoding(Val Flag) Export

ParameterCLI optionTypeRequiredDescription
Flag-BooleanFlag to use URL encoding
Returns

DataProcessorObject.OPI_HTTPClient - This processor object

tip

URL encoding is enabled by default

Caution

NOCLI: this method is not available in CLI version

1C:Enterprise/OneScript code example
URL = "https://bin.openintegrations.dev";
URL = URL + "/get";

ParametersStructure = New Structure;
ParametersStructure.Insert("param1", "search?text");
ParametersStructure.Insert("param2", "John Doe");
ParametersStructure.Insert("param3", "value&another");
ParametersStructure.Insert("param4", "кириллица");
ParametersStructure.Insert("param5", "<script>alert('XSS')</script>");

NoEncoding = OPI_HTTPRequests.NewRequest()
.Initialize("https://example.com/page")
.SetURLParams(ParametersStructure)
.UseURLEncoding(False) // <---
.ProcessRequest("GET", False)
.ReturnRequest()
.ResourceAddress;

WithEncoding = OPI_HTTPRequests.NewRequest()
.Initialize("https://example.com/page")
.SetURLParams(ParametersStructure)
.ProcessRequest("GET", False)
.ReturnRequest()
.ResourceAddress;
Result
{
"No encoding": "/page?param1=search?text&param2=John Doe&param3=value&another&param4=кириллица&param5=<script>alert(...",
"With encoding": "/page?param1=search%3Ftext&param2=John%20Doe&param3=value%26another&param4=%D0%BA%D0%B8%D1%80%D0%B8%..."
}