Lianja

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. Lianja

llSuccess = .F.

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

loRest = createobject("CkRest")

// We're going to check https://authenticationtest.com/HTTPAuth/
llBTls = .T.
lnPort = 443
llBAutoReconnect = .T.
llSuccess = loRest.Connect("authenticationtest.com",lnPort,llBTls,llBAutoReconnect)
if (llSuccess <> .T.) then
    ? loRest.LastErrorText
    release loRest
    return
endif

// Send a GET request
lcResponseText = loRest.FullRequestNoBody("GET","/HTTPAuth/")
if (loRest.LastMethodSuccess <> .T.) then
    ? loRest.LastErrorText
    release loRest
    return
endif

// 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:
? "Response status code = " + str(loRest.ResponseStatusCode)

// The ResponseStatusText property contains the text (if any) that follows the status code on the status line.
? "Response status text = " + loRest.ResponseStatusText

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


release loRest