Xbase++

Connect to a REST Server

Demonstrates Rest.Connect, which establishes the initial TCP (and optionally TLS) connection to a REST server. The example connects over HTTPS and then reuses the connection for a request.

Background. A single connection can serve many requests to the same host. The TLS argument should be _TRUE_ for HTTPS (typically port 443), and automatic reconnection lets Chilkat transparently re-establish a dropped keep-alive connection.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oRest
LOCAL nBTls
LOCAL nBAutoReconnect
LOCAL cResponseText

nSuccess := 0

oRest := CreateObject("Chilkat.Rest")

//  Connect to the REST server.  The 3rd argument enables TLS (use 1 for HTTPS on port 443),
//  and the 4th enables automatic reconnection if the connection is dropped between requests.
nBTls := 1
nBAutoReconnect := 1
nSuccess := oRest:Connect("example.com", 443, nBTls, nBAutoReconnect)
IF (nSuccess == 0)
    ? oRest:LastErrorText
    oRest:destroy()
    RETURN
ENDIF

//  The connection is now established and ready for requests.  A single connection can be reused for
//  many requests to the same server.
cResponseText := oRest:FullRequestNoBody("GET", "/api/status")
IF (oRest:LastMethodSuccess == 0)
    ? oRest:LastErrorText
    oRest:destroy()
    RETURN
ENDIF

? cResponseText

oRest:destroy()