Delphi DLL Requires Chilkat v11.0.0+

URL Encoding Charset in POST Query Params

See more HTTP Examples

Demonstrates how to control the URL encoding charset in POST query params. Delphi DLL

var
success: Boolean;
nameWin1252Encoded: PWideChar;
sb: HCkStringBuilder;
http: HCkHttp;
req: HCkHttpRequest;
resp: HCkHttpResponse;

begin
success := False;

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

//  We have the string "MÆRSK".
nameWin1252Encoded := 'M%E6RSK';

sb := CkStringBuilder_Create();
success := CkStringBuilder_DecodeAndAppend(sb,nameWin1252Encoded,'url','windows-1252');

http := CkHttp_Create();

//  We're setting the session log filename so we can see the exact request sent.
CkHttp_putSessionLogFilename(http,'qa_output/sessionLog.txt');

//  First demonstrate a simple application/x-www-form-urlencoded POST

req := CkHttpRequest_Create();

//  Set the Charset = "utf-8" to cause URL encoding to use utf-8.
CkHttpRequest_putCharset(req,'utf-8');

CkHttpRequest_AddParam(req,'name',CkStringBuilder__getAsString(sb));

CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putContentType(req,'application/x-www-form-urlencoded');

resp := CkHttpResponse_Create();
success := CkHttp_HttpReq(http,'https://www.chilkatsoft.com/something',req,resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  This is the request that is sent:
//  Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

//  	POST /something HTTP/1.1
//  	Host: www.chilkatsoft.com
//  	Content-Type: application/x-www-form-urlencoded
//  	Content-Length: 15
//  
//  	name=M%C3%A6RSK

//  ---------------------------------------------------------------
//  Switch to windows-1252

CkHttpRequest_putCharset(req,'windows-1252');
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putContentType(req,'application/x-www-form-urlencoded');

success := CkHttp_HttpReq(http,'https://www.chilkatsoft.com/something',req,resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  This is the request that is sent:
//  Notice that windows-1252 is used in the query param (the letter 'Æ' is %E6)

//  	POST /something HTTP/1.1
//  	Host: www.chilkatsoft.com
//  	Content-Type: application/x-www-form-urlencoded
//  	Content-Length: 12
//  
//  	name=M%E6RSK

//  ---------------------------------------------------------------
//  Let's do the same with HttpSReq, switching back to utf-8

CkHttpRequest_putPath(req,'/something');
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putContentType(req,'application/x-www-form-urlencoded');

CkHttpRequest_putCharset(req,'utf-8');
success := CkHttp_HttpSReq(http,'www.chilkatsoft.com',443,True,req,resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  This is the request that is sent:
//  Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

//  	POST /something HTTP/1.1
//  	Host: www.chilkatsoft.com
//  	Content-Type: application/x-www-form-urlencoded
//  	Content-Length: 15
//  
//  	name=M%C3%A6RSK

//  ---------------------------------------------------------------
//  Let's do a POST with XML body where the query params are in the HTTP request start line, 
//  and the Content-Type is text/xml where the body of the request is XML.

CkHttpRequest_putPath(req,'/something');
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putContentType(req,'text/xml');
success := CkHttpRequest_LoadBodyFromString(req,'<test>123</test>','utf-8');
CkHttpRequest_putCharset(req,'utf-8');

//  Remember... our request object still contains the query param added in the above call to AddParam.
success := CkHttp_HttpSReq(http,'www.chilkatsoft.com',443,True,req,resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  This is the request that is sent:
//  Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

//  	POST /something?name=M%C3%A6RSK HTTP/1.1
//  	Host: www.chilkatsoft.com
//  	Content-Type: text/xml
//  	Content-Length: 16
//  
//  	<test>123</test>

CkStringBuilder_Dispose(sb);
CkHttp_Dispose(http);
CkHttpRequest_Dispose(req);
CkHttpResponse_Dispose(resp);