Delphi DLL

Examine HTTP Response Status Code and Text

See more REST Examples

Demonstrates how to examine the HTTP response status code and text when using the REST object. Delphi DLL

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
rest: HCkRest;
bTls: Boolean;
port: Integer;
bAutoReconnect: Boolean;
responseText: PWideChar;

begin
success := False;

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

rest := CkRest_Create();

// We're going to check https://authenticationtest.com/HTTPAuth/
bTls := True;
port := 443;
bAutoReconnect := True;
success := CkRest_Connect(rest,'authenticationtest.com',port,bTls,bAutoReconnect);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// Send a GET request
responseText := CkRest__fullRequestNoBody(rest,'GET','/HTTPAuth/');
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// The start line of an HTTP response, called the status line, contains the following information:
// 
//     The protocol version, usually HTTP/1.1.
//     A status code, indicating success or failure of the request. Common status codes are 200, 404, or 302
//     A status text. A brief, purely informational, textual description of the status code to help a human understand the HTTP message.
// 
// A typical status line looks like: HTTP/1.1 404 Not Found.

// The ResponseStatusCode property contains the integer response code:
Memo1.Lines.Add('Response status code = ' + IntToStr(CkRest_getResponseStatusCode(rest)));

// The ResponseStatusText property contains the text (if any) that follows the status code on the status line.
Memo1.Lines.Add('Response status text = ' + CkRest__responseStatusText(rest));

// In this case, the sample output is:
// 
// Response status code = 401
// Response status text = Unauthorized

CkRest_Dispose(rest);

end;