Sample code for 30+ languages & platforms
PureBasic

HTTP GET -- Read Response from Stream

See more REST Examples

Demonstrates how to send an HTTP GET for a web page, and then read the response from a Stream. The purpose is to fulfill a situation such as the following: "I have a URL and just want the <head> </head> portion of the HTML. This would avoid having to download a potentially enormous web page just to get at header information, such as the <styles>."

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkTask.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkRest.pb"
IncludeFile "CkStream.pb"
IncludeFile "CkUrl.pb"

Procedure ChilkatExample()

    success.i = 0

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

    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; In this example, we'll get the web page at http://www.nytimes.com/pages/business/index.html
    ; The domain is "www.nytimes.com", and the path is "/pages/business/index.html"

    ; If we have only the full URL to begin with, it can be loaded into the Chilkat URL object to
    ; access the parts:
    url.i = CkUrl::ckCreate()
    If url.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkUrl::ckParseUrl(url,"http://www.nytimes.com/pages/business/index.html")

    bAutoReconnect.i = 1
    success = CkRest::ckConnect(rest,CkUrl::ckHost(url),CkUrl::ckPort(url),CkUrl::ckSsl(url),bAutoReconnect)

    ; Send the GET request (This sends the GET request, but does not read the response.)
    success = CkRest::ckSendReqNoBody(rest,"GET",CkUrl::ckPath(url))
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkUrl::ckDispose(url)
        ProcedureReturn
    EndIf

    ; Read the response header.
    responseStatusCode.i = CkRest::ckReadResponseHeader(rest)
    If responseStatusCode < 0
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkUrl::ckDispose(url)
        ProcedureReturn
    EndIf

    Debug "Response status code = " + Str(responseStatusCode)

    ; We expect a 200 response status.
    If responseStatusCode <> 200

        ; If the response status code is not 200, we could check for a redirect status code and 
        ; then follow it, read the entire response (as shown here), or just call rest.Disconnect
        errResponse.s = CkRest::ckReadRespBodyString(rest)
        If CkRest::ckLastMethodSuccess(rest) <> 1
            Debug CkRest::ckLastErrorText(rest)
        Else
            Debug errResponse
        EndIf

        CkRest::ckDispose(rest)
        CkUrl::ckDispose(url)
        ProcedureReturn
    EndIf

    bodyStream.i = CkStream::ckCreate()
    If bodyStream.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Set a 10 second read timeout for the stream. 
    ; (Give up if no data arrives within 10 seconds after calling a read method.)
    CkStream::setCkReadTimeoutMs(bodyStream, 10000)

    ; Create a background thread task to read the response body (which feeds
    ; it to the bodyStream object.)
    readResponseBodyTask.i = CkRest::ckReadRespBodyStreamAsync(rest,bodyStream,1)

    ; Start the task. 
    success = CkTask::ckRun(readResponseBodyTask)

    ; Read the HTTP response body until the "</head>" is seen, or until
    ; the end-of-stream is reached.

    sbBody.i = CkStringBuilder::ckCreate()
    If sbBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    exitLoop.i = 0
    While Not exitLoop AND (CkStream::ckEndOfStream(bodyStream) <> 1)

        bodyText.s = CkStream::ckReadString(bodyStream)
        If CkStream::ckLastMethodSuccess(bodyStream) = 1
            CkStringBuilder::ckAppend(sbBody,bodyText)
            If CkStringBuilder::ckContains(sbBody,"</head>",0)
                exitLoop = 1
            EndIf

        Else
            exitLoop = 1
        EndIf

    Wend

    ; Cancel the remainder of the task...
    CkTask::ckCancel(readResponseBodyTask)

    CkTask::ckDispose(readResponseBodyTask)

    ; Ensure we're disconnected from the server.
    maxWaitMs.i = 50
    CkRest::ckDisconnect(rest,maxWaitMs)

    Debug "----"
    Debug CkStringBuilder::ckGetAsString(sbBody)
    Debug "----"
    Debug "Successfully received the body up to the desired point."


    CkRest::ckDispose(rest)
    CkUrl::ckDispose(url)
    CkStream::ckDispose(bodyStream)
    CkStringBuilder::ckDispose(sbBody)


    ProcedureReturn
EndProcedure