(Delphi DLL) SOAP Web Service (HTTP POST)

Demonstrates how to call PostXml to call a SOAP web service.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, HttpResponse, Xml;

...

procedure TForm1.Button1Click(Sender: TObject);
var
xml: HCkXml;
success: Boolean;
strXml: PWideChar;
responseStatusCode: Integer;
http: HCkHttp;
endPoint: PWideChar;
resp: HCkHttpResponse;
xmlResp: HCkXml;

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

// --------------------------------------------------------------------------------
// Also see Chilkat's Online WSDL Code Generator
// to generate code and SOAP Request and Response XML for each operation in a WSDL.
// --------------------------------------------------------------------------------

// This example uses a live web service at:
// http://www.webservicex.net/uklocation.asmx
// It gets the UK town,Postcode and County by Postcode(First Section of Post Code)

// The SOAP XML will look like this:
// <?xml version="1.0" encoding="utf-8"?>
// <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
//   <soap:Body>
//     <GetUKLocationByPostCode xmlns="http://www.webserviceX.NET">
//       <PostCode>string</PostCode>
//     </GetUKLocationByPostCode>
//   </soap:Body>
// </soap:Envelope>

// For this example's sake, we'll load the XML from a file.  We'll test using PostCode "E3".  
// The SOAP XML for this example may be downloaded from:
// http://www.chilkatsoft.com/testData/ukPostCodeSoap.xml
xml := CkXml_Create();
success := CkXml_LoadXmlFile(xml,'ukPostCodeSoap.xml');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkXml__lastErrorText(xml));
    Exit;
  end;

strXml := CkXml__getXml(xml);

http := CkHttp_Create();

// We'll need to add this in the HTTP header:
// SOAPAction: "http://www.webserviceX.NET/GetUKLocationByPostCode"
CkHttp_SetRequestHeader(http,'SOAPAction','http://www.webserviceX.NET/GetUKLocationByPostCode');

// Some services expect the content-type in the HTTP header to be "application/xml" while
// other expect text/xml.  The default sent by Chilkat is "application/xml", but this web service
// expects "text/xml".  Therefore, change the content-type:
CkHttp_SetRequestHeader(http,'Content-Type','text/xml; charset=utf-8');

// The endpoint for this soap service is:
endPoint := 'http://www.webservicex.net/uklocation.asmx';

// Note: This particular web service was live and functioning at the time this example
// was written.  It is possible that as time progresses, this web service will no longer
// be availble...
resp := CkHttp_PostXml(http,endPoint,strXml,'utf-8');
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Memo1.Lines.Add('LastHeader:');
    Memo1.Lines.Add(CkHttp__lastHeader(http));
    Exit;
  end;

responseStatusCode := CkHttpResponse_getStatusCode(resp);
// You may wish to verify that the responseStatusCode equals 200...
Memo1.Lines.Add('Response Status Code: ' + IntToStr(responseStatusCode));

// You may examine the exact HTTP header sent with the POST like this:
Memo1.Lines.Add('LastHeader:');
Memo1.Lines.Add(CkHttp__lastHeader(http));

// Examine the XML returned by the web service:
Memo1.Lines.Add('XML Response:');
xmlResp := CkXml_Create();
CkXml_LoadXml(xmlResp,CkHttpResponse__bodyStr(resp));
Memo1.Lines.Add(CkXml__getXml(xmlResp));

// Use this online tool to generate parsing code from response XML: 
// Generate Parsing Code from XML

CkHttpResponse_Dispose(resp);

CkXml_Dispose(xml);
CkHttp_Dispose(http);
CkXml_Dispose(xmlResp);

end;